home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / pcvco13.arc / PC-VCO.DOC < prev    next >
Text File  |  1986-12-21  |  101KB  |  2,703 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.              ----------------------------------
  21.              PC-VCO: IBM PC Visual Conferencing
  22.              ----------------------------------
  23.                Communications program
  24.              ----------------------------------
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32. PC-VCO is distributed freely and may be copied by anyone for any number
  33. of machines.  The author considers PC-VCO to be "shareware" or "freeware".
  34. If the program is found to be useful or entertaining, a contribution of
  35. $35.00 is requested.  If response warrants, PC-VCO will be enhanced and
  36. extended.  The author may be reached at:
  37.  
  38.  
  39.              R. (Scott) McGinnis
  40.              P.O. Box 3607 Mdse Mart
  41.              Chicago, IL 60654-0607
  42.  
  43.              PLINK, GEnie id: TARTAN
  44.  
  45.  
  46.  
  47.  
  48.                                 Version 1.3: 861222
  49.                                 R.McGinnis; Chicago
  50.  
  51. PC-VCO: IBM PC Visual Conferencing
  52. Version 1.3: 861222
  53.  
  54.                  Table of Contents
  55.                  -----------------
  56. I.    Introduction  ................................................. page  1
  57.  
  58. II.    Running the program  .......................................... page  3
  59.  
  60. III.    CRT Display  .................................................. page  4
  61.  
  62. IV.    VCO Display  .................................................. page  5
  63.  
  64. V.    Commands - available in both modes ............................ page  7
  65.  
  66. VI.    Commands - CRT mode only ...................................... page  9
  67.  
  68. VII.    Commands - VCO mode only ...................................... page 11
  69.  
  70. VIII.    Dialing (Alt-D, Alt-R and Alt-H) .............................. page 14
  71.  
  72. IX.    Macros (Alt-M and Alt-0/9) .................................... page 17
  73.  
  74. X.    Program Configuration (Alt-S, Alt-P, Alt-O and Alt-J) ......... page 18
  75.  
  76. XI.    File Transfer (F3, F4, F5, F6, Alt-F) ......................... page 25
  77.  
  78. XII.    Miscellaneous Functions ....................................... page 29
  79.  
  80. XIII.    DOS Gateway (Alt-F10) ......................................... page 32
  81.  
  82. XIV.    Script Language ............................................... page 33
  83.  
  84. XV.    Program Requirements .......................................... page 41
  85.  
  86. XVI.    Program and Author Information    ............................... page 42
  87.  
  88.  
  89.                 Appendices
  90.                 ----------
  91. A.    Switches and Parameters ....................................... page 43
  92.  
  93. B.    PC-VCO Error display .......................................... page 46
  94.  
  95. C.    Speech Driver ................................................. page 47
  96.  
  97. D.    Exception file ................................................ page 48
  98.  
  99. E.    Files ......................................................... page 49
  100.  
  101. F.    Windowed XMODEM (WXMODEM) ..................................... page 50
  102.  
  103. G.    ANSI graphics ................................................. page 51
  104.  
  105. I.    Example Scripts ............................................... page 52
  106.  
  107. J.    Command Index ................................................. page 53
  108.  
  109.  
  110. PC-VCO: IBM PC Visual Conferencing                       Page  1
  111. Version 1.3: 861222
  112.  
  113.  
  114. I.    Introduction
  115.  
  116.  
  117.     A. What is PC-VCO?
  118.  
  119.  
  120.        PC-VCO for the IBM PC is a communications program with two sides.
  121.        On the one hand, it provides standard comm program functions: a
  122.        dialing directory, macros, disc logging, XMODEM and ASCII file
  123.        transfer, and so on.  However, used with network conferencing
  124.        services such as People/Link's PARTY, CompuServe's CB and GEnie's
  125.        RTC conferencing, PC-VCO provides a way to 'see' and 'hear' people
  126.        talking.
  127.  
  128.  
  129.        The idea for PC-VCO was derived from the VCO system, and its
  130.        predecessor/ancestor VMCO, developed for the MacIntosh computer.
  131.        The VCO programs (PC and MacIntosh) allow you to see the people you
  132.        communicate with on-line, using the graphic capabilities of the
  133.        personal computer and to hear conversation with speech synthesis.
  134.  
  135.  
  136.     B. MacIntosh VCO and VMCO
  137.  
  138.  
  139.        VCO was originally developed by Harry Chesley. It was followed by
  140.        VMCO (which is CIS specific), written by Bob Perez independant to
  141.        the development of VCO.  The current (MacIntosh) version of VCO is
  142.        almost an exact duplicate of Harry Chesley's original - the original
  143.        source code was converted by Mike Cohen and made to accept multiple
  144.        service formats.  [Note: Mike Cohen's VCO uses VMCO formated files.
  145.        Harry Chesley's VCO files differ.  VCOLIB can accomodate either.
  146.        PC-VCO in VCO mode can talk to either, according to your choice.]
  147.  
  148.  
  149.        The MacIntosh VCO allows the user to see the people talking on-line
  150.        through graphic Icons.  The Icons are provided to the VCO program
  151.        as 'Resource files' and are built using a 'Resource Editor'.  Each
  152.        VCO user must have a resource file for every potential other speaker.
  153.        Charlie Brown and Snoopy Icons are used if no 'Faces' are available.
  154.        A range of expressions, from 'normal' to bored to surprised make
  155.        VCO conferences lively.  Each participant controls the expression
  156.        displayed to all other participants.
  157.  
  158.  
  159.        The MacIntosh VCO allows the user to hear the people talking on-
  160.        line.  This is done through built in digital to analog conversion,
  161.        and a text-to-speech processor.  Each VCO user specifies the pitch
  162.        of their voice, and the rate with which they speak.    Sound effects
  163.        are possible and used heavily, of course.
  164.  
  165.  
  166. PC-VCO: IBM PC Visual Conferencing                       Page  2
  167. Version 1.3: 861222
  168.  
  169.  
  170. I.    Introduction (continued)
  171.  
  172.  
  173.     C. This program
  174.  
  175.  
  176.        PC-VCO Version 1.3 executes as a CRT based comm program either in
  177.        text mode on a CGA display, or on a monochrome screen.  It executes
  178.        VCO mode in CGA hi-res graphics mode, and displays faces extracted
  179.        from MacIntosh resource files.  A face librarian (VCOLIB) has been
  180.        included to maintain a library of faces and to create face files
  181.        for other PC-VCO and for MacIntosh users.
  182.  
  183.  
  184.        Version 1.3 of PC-VCO interfaces to a public domain resident speech
  185.        driver.  Pitch and speaking rate cannot be set.  The voice quality
  186.        is what might be expected without digital-to-analog conversion.
  187.        However, the interface is proven, and future versions will interface
  188.        to other speech drivers, as and if they become available.
  189.  
  190.  
  191.        PC-VCO may be copied freely and distributed to anyone for any number
  192.        of machines.  The author considers PC-VCO to be "shareware" or "free-
  193.        ware".  If the program is found to be useful or entertaining, a con-
  194.        tribution is asked.    PC-VCO will be extended and enhanced if response
  195.        warrants.
  196.  
  197.  
  198.     D. This document
  199.  
  200.  
  201.        This document describes the features of PC-VCO - both standard
  202.        communications features and the VCO side.  A program of this kind,
  203.        i.e. one with two wildly different sides is hard to describe.
  204.        Bear with me, please, as I hop from side to side, sometimes landing
  205.        astride the middle (ouch!).
  206.  
  207.  
  208.        The CRT screen will be discussed first, followed by the VCO screen
  209.        (which really must be seen to be grasped).  Then program commands
  210.        are summarized - divided, of course, into CRT, VCO and both side
  211.        sets.  The chapters following discuss some program functions in
  212.        depth.  Appendices provide details for very interested readers.
  213.  
  214.  
  215. PC-VCO: IBM PC Visual Conferencing                       Page  3
  216. Version 1.3: 861222
  217.  
  218.  
  219. II.    Running the program
  220.  
  221.  
  222.     PC-VCO is invoked at the DOS prompt with the command:
  223.  
  224.     ------------------------------------------------------
  225.     "d>" PC-VCO <options>
  226.  
  227.     Where "d>" is the DOS prompt, and
  228.           <options> is (<parm> (<parm> ...))
  229.           where <parm> is either a switch or a parameter
  230.  
  231.     Refer to Appendix A for a full description of switches
  232.     and parameters.
  233.     ------------------------------------------------------
  234.  
  235.     PC-VCO would be invoked with a command such as:
  236.  
  237.            "d>" PC-VCO
  238.  
  239.     or, for example the command:
  240.  
  241.            "d>" PC-VCO DIAL 1
  242.  
  243.     to dial directory entry #1 as soon as PC-VCO is loaded.
  244.  
  245.     The command:
  246.  
  247.            "d>" PC-VCO /F SCRIPT.CMD
  248.  
  249.     would be used to perform the logon sequence contained in the
  250.     file SCRIPT.CMD.
  251.  
  252.  
  253.     PC-VCO requires no other file for its execution.  It will create
  254.     a parametrization file, dialing directory, and macro definition
  255.     if none are present.  The face library and speech driver exeception
  256.     files are not necessary to execution as a communications program.
  257.     They are necessary, however, to PC-VCO's execution as a VCO style
  258.     communications program.
  259.  
  260.  
  261.     Files used by PC-VCO and provided with the distribution are
  262.     discussed in Appendix E.
  263.  
  264.  
  265. PC-VCO:  IBM PC Visual Conferencing                       Page  4
  266. Version 1.3:  861222
  267.  
  268.  
  269. III.    CRT Display
  270.  
  271.  
  272.     When PC-VCO is set to text (CRT) mode (the default mode), the PC
  273.     performs as a 24-line CRT.  The first 24 lines are a scrolling region.
  274.     The 25th line is used for Program Identification, status and keyboard
  275.     display.  Carriage returns received cause the text area to scroll.
  276.  
  277.  
  278.     What is typed in at the keyboard is transmitted out the COM port.
  279.     What is received through the COM port is displayed on the screen.
  280.     Received line feeds are thrown away.  Non-printables are also thrown
  281.     away.  Received characters may be masked to 7 bits (parity masking is
  282.     optional).
  283.  
  284.  
  285.     In order to connect to a network you must dial the phone number
  286.     of the Network node you wish to access.  For example, with Smart-
  287.     modem, the following sequence might be typed:
  288.  
  289.          AT E1 DT 245-9110 <return>
  290.  
  291.  
  292.     This sequence instructs the Smartmodem to echo entry (E1) and dial
  293.     using Tone dialing (DT) PLINK Chicago (245-9110) as a local call.
  294.     Modem initialization would be done between the E1 and DT as needed.
  295.  
  296.  
  297.     This sequence is automated in PC-VCO through a dialing directory
  298.     (Alt-D).  Phone numbers and parameters are maintained in the
  299.     directory.  Services are called through the same Alt-D command.
  300.  
  301.  
  302.     Initialization of the modem is performed automatically by PC-VCO
  303.     as well.  The modem initialization string specified through the
  304.     Setup function (Alt-S) is issued to the modem when PC-VCO is
  305.     loaded - after the modem port is initialized to the default rate,
  306.     parity, data and stop bits specified through the .DFT file.  Comm
  307.     Parms are changed and the .DFT file updated with the function Alt-P.
  308.  
  309. PC-VCO:  IBM PC Visual Conferencing                       Page  5
  310. Version 1.3:  861222
  311.  
  312.  
  313. IV.    VCO Display
  314.  
  315.  
  316.     When the screen is placed into graphic (VCO) mode, the screen is
  317.     divided into several areas.  The top line carries the program version
  318.     and release number, the current 'expression mode' and the VCO Main menu.
  319.     The next eight lines (of text if we were in text mode) carries Icons
  320.     for 10 (potential) people (faces).
  321.  
  322.  
  323.     Initially the Icons are displayed as empty chairs.  A large (double
  324.     wide ICON) box beneath the 10 empty chairs will be the speaker's box.
  325.     [This does not appear if the program was run with the /M switch.]
  326.     The Icon of the current Speaker will be displayed here.  The
  327.     conversation scrolls in the region to the right of the Speaker's box
  328.     (the bottom line of the text area being reserved for program use).
  329.  
  330.  
  331.     Beneath this activity are Icons for 10 more people.  Icons are used
  332.     in simple sequential order, as new people speak.  Icons which are 'in
  333.     use' may be deleted - say, if the individual has left the area.
  334.     Under certain conditions, PC-VCO will delete an ICON itself.
  335.  
  336.  
  337.     In conversation, when a speaker is identified (through the ID or
  338.     handle - see following), one of several things may happen:
  339.  
  340.     . If we've never seen the ID before, and we have an empty chair:
  341.  
  342.       The first empty chair Icon is replaced by an Icon representing
  343.       the new speaker with a 'normal' expression.  The Icon is also
  344.       displayed in the Speaker's box (reversed - we've never seen the
  345.       person before).  Notice the difference between speaking and sitting
  346.       ICONS.
  347.  
  348.     . If we've never seen the ID before, and we have no empty chair:
  349.  
  350.       An Icon representing the Speaker with a 'Normal' expression is
  351.       displayed in the Speaker's box.
  352.  
  353.     . If we've seen the ID before:
  354.  
  355.       The Icon of the speaker is displayed in the speaker's box (not
  356.       reversed - we've seen 'em before) and the Icon above or below
  357.       is reversed.
  358.  
  359. PC-VCO:  IBM PC Visual Conferencing                       Page  6
  360. Version 1.3:  861222
  361.  
  362.  
  363. IV.    VCO Display (continued)
  364.  
  365.  
  366.     IDs and handles are identified in conversation using the following
  367.     templates (handles are assumed names which replace or add to an ID):
  368.  
  369.     ------------------------------------------------------------------
  370.     PLINK IDs and handles:
  371.           "(" <ID> ") "          an initial "*" identifies handles
  372.  
  373.     Example:  (TARTAN) This is how a line would look on PLINK
  374.     ------------------------------------------------------------------
  375.     GEnie IDs and handles:
  376.           "<" [Handle] <ID> "> "
  377.  
  378.     Example:  <[Scott] TARTAN> This is how a line would look on GEnie
  379.     ------------------------------------------------------------------
  380.     CIS handles:
  381.           "(" <Band> , <ID> ") "
  382.                where <Band> ::= (A!B)(N!NN)","
  383.  
  384.     Example:  (A1,TARTAN) This is how a line would look on CIS
  385.     ------------------------------------------------------------------
  386.     Delphi IDs and handles:
  387.           <ID> "> "             an initial "." identifies handles
  388.  
  389.     Example:  TARTAN> This is how a line would look on Delphi
  390.     ------------------------------------------------------------------
  391.  
  392.  
  393.     The ID or handle parse begins after a carriage return from the network.
  394.     The Icon display is updated as soon as an ID is identified.  The text is
  395.     displayed in any case.    If no ID is identified, no ICON is changed.
  396.     Blank lines (extra carriage returns issued by the network) are not
  397.     displayed by PC-VCO because of the limited text area (7 lines).
  398.  
  399.  
  400.     One anomaly occurs with the parser ... when a VCO command is alone
  401.     on a line, the ID is displayed with no text following it.  VCO internal
  402.     commands (such as expression changes) exchanged amongst VCO attendees
  403.     are not displayed as text of a conversation.  PC-VCO does not know if
  404.     a text line is empty or not until the entire line is received.    PC-VCO
  405.     erases an empty text line (visible as an ID followed by no text) and
  406.     re-uses the line when end-of-line (carriage return) is received.
  407.  
  408.  
  409.     The PC-VCO parser is only designed to deal with text issued within the
  410.     conversational area of one of the above systems.  The parser is self-
  411.     adjusting ... all of the above formats will be taken as conversation.
  412.     The VCO side is not altogether appropriate for other uses, such as
  413.     reading your mail.  For other uses, swich to the alpha side (F1).
  414.  
  415.  
  416. PC-VCO:  IBM PC Visual Conferencing                       Page  7
  417. Version 1.3:  861222
  418.  
  419.  
  420. V.    Commands - available in both modes
  421.  
  422.  
  423.     PC-VCO provides the following command keys in both modes:
  424.  
  425.     F1    Switch between text (CRT) and graphic (VCO) modes.  The
  426.         switch always clears the table of Icons and IDs, so a switch
  427.         from VCO to CRT and back will always clear a clutter.
  428.  
  429.     F10    Help screen.  All currently implemented commands are
  430.         summarized on this screen.  Any command may be executed
  431.         directly while this screen is displayed.
  432.  
  433.     Alt-F10 DOS Gateway.  If there is sufficient memory available, and if
  434.         the environment variable "COMSPEC" identifies a valid .COM or
  435.         .EXE file, PC-VCO will load the program and execute it.  This
  436.         normally is used to load a second copy of COMMAND.COM for full
  437.         access to DOS while a communication session is in progress.
  438.  
  439.     Ctl_End Send a Break.  This sends a true 'break' signal.
  440.  
  441.     Alt-A    Turn split screen 'chat mode' on and off.  The screen is split
  442.         in chat mode - one window for received text, and one for typed.
  443.         The size of the chat window is set through Alt-S setup.
  444.  
  445.     Alt-B    Redisplay (backscreen).  The speed of the display may be
  446.         controlled using Cntl-PgDn (slower) or Cntl-PgUp (faster).
  447.  
  448.     Alt-C    Clear the screen.
  449.  
  450.     Alt-D    Dialing directory.  The Dialing directory and file is
  451.         identical to that used by Procomm (version 2.x), to allow
  452.         files to be shared between the two programs.
  453.  
  454.     Alt-E    Toggle echo (full/half duplex).  This function is also
  455.         invoked through the dialing directory (echo on).
  456.  
  457.     Alt-F    File directory.  A mask is required - just as DOS DIR command.
  458.  
  459.     Alt-G    Toggle blank line suppression.    PC-VCO will suppress blank
  460.         lines on the CRT side if you wish.  This can be made a program
  461.         default through the Alt-O options menu.
  462.  
  463.     Alt-H    Hang-up.  Hang-up the phone.
  464.  
  465.     Alt-I    Program information.  Author information.  Propaganda.
  466.  
  467.  
  468. PC-VCO:  IBM PC Visual Conferencing                       Page  8
  469. Version 1.3:  861222
  470.  
  471.  
  472. V.    Commands - available in both modes (continued)
  473.  
  474.  
  475.     Alt-J    Set screen colors.  You may foreground and background color
  476.         values for the CRT screen, the status line, and menu windows.
  477.         Note that ANSI graphics require colors be turned off.
  478.  
  479.     Alt-M    Define a macro for Alt-0 through Alt-9.  The Macro definition
  480.         and file will be identical to that used by Procomm (vers 2.x),
  481.         to allow Macros to be shared between the two programs.
  482.  
  483.     Alt-P    Comm Parameters.  Set baud rate, parity, number of data and
  484.         stop bits.  These settings are overridden by run-time switches.
  485.         Whatever the current setting, the dialing directory overrides.
  486.  
  487.     Alt-R    Redial the last number dialed.    The program will redial the
  488.         number until the function is terminated (with ESC), or
  489.         connection is made.
  490.  
  491.     Alt-S    Setup.    Define initial program values, such as Modem initial-
  492.         ization, the Modem Hang-up sequence, and file names.
  493.  
  494.     Alt-T    Elapsed time.  The time the program was loaded, and the time
  495.         the last call (Alt-C or Alt-R) was placed are displayed.  The
  496.         elapsed time since the latest time is also displayed.
  497.  
  498.     Alt-V    Toggle the voice driver.  You may turn the voice driver off,
  499.         and back on (in implicit mode, see below) with this command.
  500.  
  501.     Alt-X    Exit the program.  The program may or may not hang-up the
  502.         phone, depending on the modem.    If piggyback was specified,
  503.         the line should not be disconnected.
  504.  
  505.     Alt-Z    Toggle parity mask.  The high bit mask is used only for text
  506.         received and displayed - it has no effect on XMODEM transfers.
  507.  
  508.     Alt-0/9 Send a Macro.  A string of characters defined through the
  509.         Alt-M command described above is transmitted.
  510.  
  511. PC-VCO:  IBM PC Visual Conferencing                       Page  9
  512. Version 1.3:  861222
  513.  
  514.  
  515. VI.    Commands - CRT mode only
  516.  
  517.  
  518.     PC-VCO provides the following command keys only in CRT mode:
  519.  
  520.  
  521.     F2    Execute a script.  A window is opened to request the name of
  522.         the script file.  No default extension is assumed or added.
  523.  
  524.         This function is not available on the VCO side.
  525.  
  526.     F3    XMODEM upload.    Files may be transferred to a system that can
  527.         accept CHECKSUM/CRC XMODEM, or WXMODEM.  You are asked for a
  528.         a file name.  Once the file's existence has been assured,
  529.         PC-VCO begins protocol negotiation with the host system.  Up to
  530.         60 seconds are allowed for the receiver (the host system) to
  531.         begin the transfer.
  532.  
  533.         PC-VCO changes the communications parameters to 8 data bits,
  534.         no parity, and 1 stop bit when XMODEM begins.  It restores
  535.         the settings to their previous value after XMODEM completes.
  536.  
  537.         This function is not available in VCO mode.
  538.  
  539.     F4    XMODEM download.  Files may be transferred from a system that
  540.         can send CHECKSUM/CRC XMODEM, or WXMODEM.  You are asked for a
  541.         file name.  Once the file has been created (it will be purged if
  542.         it already existed), PC-VCO begins protocol negotiation with the
  543.         host system.  PC-VCO first tries to negotiate WXMODEM.    If the
  544.         host does not acknowlege WXMODEM, CRC XMODEM is requested.  If
  545.         the host does not acknowlege CRC, CHECKSUM is requested.  Up to
  546.         100 seconds are allowed for this negotiation.
  547.  
  548.         PC-VCO changes the communications parameters to 8 data bits,
  549.         no parity, and 1 stop bit when XMODEM begins.  It restores
  550.         the settings after XMODEM completes.
  551.  
  552.         This function is not available in VCO mode.
  553.  
  554.     F5    ASCII upload.  Files may be transferred to a system using a
  555.         simple 'send' (as if they were entered by hand).  Transfer may
  556.         occur with or without a host prompt (some special character
  557.         issued for every line.    Transfer timed (paced) in either case.
  558.         Line feeds may or may not be suppressed.  Tab characters may
  559.         or may not be expanded as blanks.
  560.  
  561.         This function is not available in VCO mode.
  562.  
  563.  
  564. PC-VCO:  IBM PC Visual Conferencing                       Page 10
  565. Version 1.3:  861222
  566.  
  567.  
  568. VI.    Commands - CRT mode only (continued)
  569.  
  570.  
  571.     F6    ASCII download.  This differs from transcripting in that no
  572.         extra characters are added to the file (line feeds after
  573.         received carriage returns, or end-of-file).  Transcripting
  574.         is intended to result in an ASCII edit file - or a printed
  575.         log.  ASCII download may be used to save sessions (or parts
  576.         of sessions) exactly as received.
  577.  
  578.         This function is not available in VCO mode.
  579.  
  580.     F7    Logging or transcripting.  Log received text to a disk file
  581.         or device.  You specify the file to be used.  If not empty,
  582.         new logging will be appended to the end of the existing file.
  583.  
  584.         You will next be asked if the backscreen (the last 4096
  585.         characters received) is to be saved.  This way, logging need
  586.         not be started before an event occurs that you wish to record.
  587.  
  588.         Note that what is logged is exctly what is displayed on the
  589.         screen.  If hi-bit masking is turned on, characters will be
  590.         logged with their high bit turned off.    Line feeds are added
  591.         after carriage returns.  An ASCII end-of-file is added when
  592.         file is closed.
  593.  
  594.         Opening and closing the log is marked with date and time.
  595.         The transcript marking may be turned off with the Alt-O
  596.         function.  Log hold (below) does not mark the log.
  597.  
  598.         This function is controlled through a pull-down in VCO mode.
  599.  
  600.     F8    Toggle display of typed characters (for use with half duplex
  601.         circuits - otherwise known as 'no echo').  The keyboard
  602.         display will occur on the 25th line in CRT mode, and below
  603.         the scrolling window in VCO mode.
  604.  
  605.         This function is controlled through a pull-down in VCO mode.
  606.  
  607.     F9    Hold the log - no entry will be made to the log from this
  608.         point until hold is turned off (by pressing F9 again) or the
  609.         log is closed.    The fact of the log being held is displayed
  610.         on the status line (or below the scolling window in VCO mode).
  611.  
  612.         This function is controlled through a pull-down in VCO mode.
  613.  
  614.     ---------------------------------------------------------------
  615.     Note also functions defined above under "Commands - both modes".
  616.     ---------------------------------------------------------------
  617.  
  618.  
  619. PC-VCO:  IBM PC Visual Conferencing                       Page 11
  620. Version 1.3:  861222
  621.  
  622.  
  623. VII.    Commands - VCO mode only
  624.  
  625.  
  626.     On the top line of the display in VCO mode there is a menu of key-
  627.     words.    A keyword is selected, and a submenu pulled-down.  Submenu
  628.     items are selected, and executed.  The keywords are:
  629.  
  630.     Controls    Select certain control functions.  Controls are:
  631.  
  632.             .  Turn Speaker's Box on (default mode)
  633.             .  Turn Speaker's box off ('Maug' mode)
  634.             .  Playback:  Play a transcript
  635.             .  Turn Transcript logging on and off.
  636.             .  Turn keyboard display on and off.
  637.             .  Suspend the log function (temporarily).
  638.             .  Change expression set (PLINK/CIS or Delphi/GEnie)
  639.  
  640.     Sounds        Issue 'sound' commands to the conference (and to
  641.             yourself, unless you've disabled 'bounceback').
  642.             The current selections are clunky... they'll get
  643.             better as time goes on.
  644.  
  645.     Speech        Turn the speech driver on (two modes) and off.    The
  646.             resident speech driver must be loaded prior to PC-VCO.
  647.  
  648.     Faces        Issue 'expression' commands to the conference.  This
  649.             causes the Icon displayed for your ID to be changed
  650.             on your screen, and on any other screen receiving
  651.             your command.
  652.  
  653.     Top-line menu items are selected with the Cursor right key.  When the
  654.     cursor-right is depressed,  the next menu item (in a circular manner)
  655.     is highlighted.  The highlighted keyword is 'selected'.
  656.  
  657.     A submenu is pulled-down with the Cursor-down key (or End, or PgDn).
  658.     A submenu item is selected from a pull-down when it is highlighted
  659.     by pressing the Cursor-down key repetively.  When the Cursor-down
  660.     key is depressed, the next submenu item (again in a circular manner)
  661.     is highlighted.  The highlighted keyword is 'selected'.
  662.  
  663.     A selected submenu item is executed with a Carriage Return.  That's
  664.     the key with the silly arrow.  When a submenu item is executed, the
  665.     pull-down is released (it goes back up?).  Hitting the Space-bar will
  666.     also execute the selected item.
  667.  
  668.     A pull-down is released without executing any item with any of the
  669.     following keys: ESC, Home, PgUp.
  670.  
  671.     Unimplemented submenues or keys beep at you.
  672.  
  673. PC-VCO:  IBM PC Visual Conferencing                       Page 12
  674. Version 1.3:  861222
  675.  
  676.  
  677. IV.    Commands - VCO mode only (continued)
  678.  
  679.  
  680.     As mentioned above in the introduction, there are three forms of VCO
  681.     in use on Macintosh computers.    The three programs use two different
  682.     file formats for face files.  PC-VCO can accomodate both file formats.
  683.     It can speak to all three MacIntosh programs over a network (only one
  684.     type at a time, of course).
  685.  
  686.  
  687.     VCO, as written by Harry Chesley is currently in use on Delphi and
  688.     GEnie.    This is the original VCO program.  The face file defined for
  689.     Harry Chesley's program is not the format PC-VCO was originally
  690.     written to accomodate.    However, Version 1.3 of PC-VCO will accept
  691.     Chesley formatted face files, and switch expression sets at will.
  692.  
  693.  
  694.     VMCO was written independant of, but with knowlege of Harry Chesley's
  695.     VCO by Bob Perez.  VMCO defined a slightly different face file format.
  696.     VMCO is currently in use on CIS.  PC-VCO has always been compatible
  697.     with VMCO.  However, it is not the program PC-VCO was written to match.
  698.  
  699.  
  700.     Harry Chesley's original VCO was modified by Mike Cohen to parse
  701.     PLINK ID's.  The VMCO face file format was used for this version.
  702.     This is the version of VCO that PC-VCO was coded to match.
  703.  
  704.  
  705.     On the top line of the VCO screen, the expression set currently in use
  706.     is displayed (either 'PLINK/VCO' or 'Delphi/GEnie').  The mode may be
  707.     dynamically changed through the 'Controls' pull-down.  The mode in
  708.     effect when the program is loaded defaults to PLINK/CIS... but the
  709.     default may be permanently changed through the Alt-O (Options) Menu
  710.     (see below), or through a run-time switch (see Appendix A).
  711.  
  712.  
  713.     Understand, please, that different expression sets are defined by the
  714.     face file.  All users (Macintosh especially) must be using compatible
  715.     sets for expressions to be exchanged meaningfully.  VMCO and Mike
  716.     Cohen's VCO use different expression commands from Harry Chesley's VCO.
  717.     PC-VCO can talk to one group or the other.  But not both at the same
  718.     time.  Users of Harry Chesley's VCO cannot talk to users of Mike Cohen's
  719.     VCO, or to users of VMCO (and exchange expressions).
  720.  
  721.  
  722. PC-VCO:  IBM PC Visual Conferencing                       Page 13
  723. Version 1.3:  861222
  724.  
  725.  
  726. VII.    Commands - VCO mode only (continued)
  727.  
  728.  
  729.     Other keys that are active on the VCO screen alone are:
  730.  
  731.  
  732.     DEL    Select an Icon for removal.  Press the DEL key, and an 'X'
  733.         covers the next Icon around the table.    Move the 'X' to the
  734.         Icon to be deleted (e.g. the speaker has left).  The Icon
  735.         is then deleted with the INS key.
  736.  
  737.     INS    Delete the selected Icon.  The Icon is replaced with the
  738.         empty chair Icon, and the ID of the person represented
  739.         is removed from the program's tables.  If no Icon is
  740.         selected, the program beeps.
  741.  
  742.  
  743.     PC-VCO implements an autodelete function that automatically removes
  744.     ICONs of people that have left the conversation.  VCO users on PLINK
  745.     and CIS enter "-OFF-" alone on a line to signal that they are leaving.
  746.     GEnie users rely on the system reporting that "<ID> has left."  or
  747.     that "<ID> disconnected.".  PC-VCO recognizes these strings, and
  748.     automatically deletes the approriate ICON.
  749.  
  750.  
  751.     Special keys (i.e. non-ASCII) will be implemented as control keys
  752.     as requirements and experience dictate.  Unimplemented keys beep.
  753.  
  754.     ---------------------------------------------------------------
  755.     Note also functions defined above under "Commands - both modes".
  756.     ---------------------------------------------------------------
  757.  
  758. PC-VCO:  IBM PC Visual Conferencing                       Page 14
  759. Version 1.3:  861222
  760.  
  761.  
  762. VIII.    Dialing (Alt-D, Alt-R, and Alt-H)
  763.  
  764.  
  765.     A. Dialing directory (Alt-D)
  766.  
  767.        . Dial from directory
  768.  
  769.          The dialing directory is invoked with the Alt-D command, avail-
  770.          able in either CRT or VCO mode.  After the directory window is
  771.          opened, an entry may be dialed simply by entering the appropr-
  772.          iate number.  The directory entry does not have to be on screen.
  773.  
  774.          The number you enter may be preceeded or suffixed with a long
  775.          distance entry code (+,-,#,@).  The long distance entry string
  776.          will precede the dialed number.  Timing commands (e.g. Smart-
  777.          modem use of "," to pause for a fixed time) may be included.
  778.  
  779.          The modem dialing string specified through the Alt-S window is
  780.          issued, the long distance number is issued, then the directory
  781.          entry telephone number is issued, and finally the dialing
  782.          suffix string specified through the Alt-S screen.
  783.  
  784.          Communications parameters must be selected when you create the
  785.          dialing directory entry.  Each service requires certain settings
  786.          for comprehensible communications.  However, one note:  PC-VCO
  787.          will change settings to 8 data bits, no parity and 1 stop bit
  788.          when XMODEM file transfer is begun.  When XMODEM completes, the
  789.          previous settings are reinstated.    You only need to know what
  790.          the specific service requires for conversational mode.
  791.  
  792.  
  793.        . Manual dialing (M)
  794.  
  795.          From the Alt-D dialing directory, you may invoke manual dialing
  796.          with the command "M".  You will be asked to enter a number to be
  797.          dialed.  Enter the number you wish to dial - it will be prefixed
  798.          with the modem dialing string (specified through the Alt-S window)
  799.          suffixed with the dialing suffix, and issued.
  800.  
  801.  
  802.          Manually dialed numbers use the communications parameters in
  803.          effect at the time the number is dialed.  The rule for comm
  804.          parameters is: The Comm Parms window (Alt-P) is overridden by
  805.          run-time parameters; the setting specified by the (last) dialing
  806.          directory entry used (if any) override both.
  807.  
  808. PC-VCO:  IBM PC Visual Conferencing                       Page 15
  809. Version 1.3:  861222
  810.  
  811.  
  812. VIII.    Dialing (continued)
  813.  
  814.  
  815.     B. Dialing directory maintenance (Alt-D)
  816.  
  817.        . Revise entry (R)
  818.  
  819.          A directory entry may be revised with the "R" command on the Alt-D
  820.          window.  You will be prompted for values.    Enter each value as you
  821.          want it to be - you can cancel the sequence at any prompt with the
  822.          ESC key.  When you've completed all the prompts you will be asked
  823.          whether the change is to be saved to disk - if you say no (N),
  824.          the change will not be available the next time you call up PC-VCO.
  825.  
  826.        . Delete entry (D)
  827.  
  828.          A directory entry may be deleted with the "D" command on the Alt-D
  829.          window.  You will be prompted for for the entry number (you may use
  830.          the command "Dn" too, where "n" is the entry number).  The chosen
  831.          entry is displayed - if you answer "y" to the query, the entry will
  832.          be deleted in memory and on disk.
  833.  
  834.        . Revise Long distance directory (L)
  835.  
  836.          The Long distance directory is a directory within a directory.
  837.          Four entries may be created (labelled: "+", "-", "#", and "@") and
  838.          then used to prefix a dialing command (or to suffix, if you will).
  839.  
  840.          The Long distance entry is free form - any string that your modem
  841.          will accept may be entered.  The Long distance directory is pulled-
  842.          up from the Alt-D window with the command "L".  An entry may be
  843.          modified by choosing a label ("+","-","#", or "@").
  844.  
  845.        . Print directory (P)
  846.  
  847.          The dialing directory (current in memory) may be printed from
  848.          the Alt-D window with the command "P".  Printer output is directed
  849.          to the standard output device (PRN).  You are prompted to ready
  850.          the printer - strike any key except ESC to begin printing.  ESC
  851.          will cancel the request.
  852.  
  853.          The printed directory is two pages of 50 lines (plus heading).
  854.          Top-of-forms (decimal 12) are issued at the start of each page.
  855.          Column headings are similar to the headings of the Alt-D window.
  856.  
  857.  
  858. PC-VCO:  IBM PC Visual Conferencing                       Page 16
  859. Version 1.3:  861222
  860.  
  861.  
  862. VIII.    Dialing (continued)
  863.  
  864.  
  865.     C. Re-dial (Alt-R)
  866.  
  867.        The last dialing directory entry used to dial (or manual number
  868.        as entered) may be recalled and re-dialed.  The re-dial sequence
  869.        cycles.  It waits for the "Connect string" (as specified through
  870.        the Alt-S window) for a fixed period, then resets the modem using
  871.        the "Escape string" and tries again.  Time spent re-dialing is
  872.        updated every time a re-dial is attempted.
  873.  
  874.        You may force a new attempt with the space-bar.  You may change the
  875.        delay interval by pressing the END key - you will be prompted for
  876.        a new value in seconds.
  877.  
  878.  
  879.     D. Hang-up (Alt-H)
  880.  
  881.        The connection (if any) may be interrupted and the "Hang-up string"
  882.        (specified through the Alt-S window) issued with the Alt-H command.
  883.        The "Modem escape" string is issued first - which takes several
  884.        seconds.  When the "Hang-up string" has been sent, acknowlegement
  885.        is issued to the screen.
  886.  
  887.  
  888. PC-VCO:  IBM PC Visual Conferencing                       Page 17
  889. Version 1.3:  861222
  890.  
  891.  
  892. IX.    Macros (Alt-M and Alt-0/9)
  893.  
  894.  
  895.     A. Revise entry (R)
  896.  
  897.        PC-VCO is distributed with an empty Macro directory.  Entries may
  898.        be displayed and modified through the Alt-M command.  A macro entry
  899.        is any string of text which you may wish to issue on-line.  Carriage
  900.        returns may be embedded in the string (as exclamation points "!" ...
  901.        Exclamation points themselves must be entered as two: "!!").  Control
  902.        characters may be embedded in the string (represented as caret/letter
  903.        "^x" ... ^a = 1, ^b = 2, and so on... carets themselves must
  904.        themselves be represented as two: "^^").
  905.  
  906.        Select the entry number to be revised by entering its number (0...9).
  907.        You will be prompted for the new entry.  Enter a single blank if you
  908.        wish to delete the entry.
  909.  
  910.     B. Execute entry (Alt-0 through Alt-9)
  911.  
  912.        Macros are issued with the commands Alt-0 through Alt-9.  The entry
  913.        indicated by the number will be immediately issued.    What happens
  914.        after that is strictly up to what you've entered, the service you're
  915.        on, and the people around you.
  916.  
  917.  
  918. PC-VCO:  IBM PC Visual Conferencing                       Page 18
  919. Version 1.3:  861222
  920.  
  921.  
  922. X.    Program Configuration (Alt-S, Alt-P, Alt-O, and Alt-J)
  923.  
  924.  
  925.     A. Setup Screen (Alt-S)
  926.  
  927.        1. Modem control
  928.  
  929.           . Modem initialization string
  930.  
  931.         The modem initialization string is issued (output to the comm
  932.         port) when PC-VCO is first loaded, and every time you change
  933.         COM port (through the Alt-P window).  If blanked, it will be
  934.         ignored.  Note that carriage returns and control characters
  935.         are specified as with macros.
  936.  
  937.           . Modem dialing prefix
  938.  
  939.         The Modem dialing prefix commands the modem to enter a dialing
  940.         sequence, using the directory number (and long distance string,
  941.         if used).  It may be any string appropriate to your modem.
  942.  
  943.           . Modem dialing suffix
  944.  
  945.         The Modem dialing string terminates each dialing command.  For
  946.         Hayes type modems it should be a "!" (translated by PC-VCO to
  947.         be a <cr>).  It be any string appropriate to your modem.  Note
  948.         that carriage returns and control characters are specified as
  949.         with macros.
  950.  
  951.           . Hangup string
  952.  
  953.         The hang-up string is issued through the Alt-H command (after
  954.         a modem escape is issued).  Note that carriage returns and
  955.         control characters are specified as with macros.  Delays of
  956.         1/2 second each may be specified with the tilde (~).
  957.  
  958.           . Escape string
  959.  
  960.         The modem escape is issued before the hang-up string (Alt-H),
  961.         and before each re-dial (Alt-R).  Delays of 1/2 second each
  962.         are specified with a tilde (~).  Timing for this function is
  963.         dependant on the millisecond loop value (below).  Note that
  964.         carriage returns and control characters are specified as with
  965.         macros.
  966.  
  967.           . Connect string
  968.  
  969.         The connect string is used by the Alt-R re-dial command to
  970.         determine when connection has been made.
  971.  
  972. PC-VCO:  IBM PC Visual Conferencing                       Page 19
  973. Version 1.3:  861222
  974.  
  975.  
  976. X.    Program Configuration (continued)
  977.  
  978.  
  979.     A. Setup Screen (continued)
  980.  
  981.        2. Files
  982.  
  983.           . Default log file
  984.  
  985.         The default Log file name will be used if a blank is entered
  986.         in response to the transcript file name query (F7 in CRT mode,
  987.         and Controls pull-down in VCO mode).  Once a file name is used
  988.         in response to this query it will be carried along (while the
  989.         program is running).  The default Log file name is invoked
  990.         again by entering the name, or a blank.
  991.  
  992.           . Dialing directory
  993.  
  994.         The dialing directory file is used to initialize the program's
  995.         dialing directory.  The directory is compatible with PROCOMM
  996.         (version 2.x).    You can cross the two by entering the PROCOMM
  997.         dialing directory file name here (with subdirectory as
  998.         required).
  999.  
  1000.         When you change this entry, the current dialing directory is
  1001.         closed, and the new file opened/created.
  1002.  
  1003.           . Macro Directory
  1004.  
  1005.         The macro directory file is used to initialize the program's
  1006.         macro definitions.  The file is compatible with PROCOMM
  1007.         (version 2.x).    You can cross the two by entering the PROCOMM
  1008.         directory file name here (with subdirectory as required).
  1009.  
  1010.         When you change this entry, the current dialing directory is
  1011.         closed, and the new file opened/created.
  1012.  
  1013.           . Exception file
  1014.  
  1015.         The exception file name is used when voice is turned on.  If it
  1016.         does not exist, none will be created.  You can create one by
  1017.         following the rules in Appendix D of this document.  Something
  1018.         towards an exeception file is provided in the release ARC.
  1019.  
  1020.           . Face library
  1021.  
  1022.         The face library is built and maintained through the VCOLIB
  1023.         face librarian program.  MacIntosh resource files are added
  1024.         to this file to add faces to the VCO side of this program.
  1025.         This file defines the set of faces 'known' to the VCO side.
  1026.  
  1027.  
  1028. PC-VCO:  IBM PC Visual Conferencing                       Page 20
  1029. Version 1.3:  861222
  1030.  
  1031.  
  1032. X.    Program Configuration (continued)
  1033.  
  1034.  
  1035.     A. Setup Screen (continued)
  1036.  
  1037.        3. Timings and Values
  1038.  
  1039.           . Millisecond loop
  1040.  
  1041.         The millisecond loop value gives the number of LOOP instruc-
  1042.         tions required to wait for one millisecond.  This type of timing
  1043.         function is used in PC-VCO in several places: 1) to issue the
  1044.         modem escape, 2) to control the break duration, and 3) to pace
  1045.         displays such as Alt-B backscreen.  260 is suggested for 4.77
  1046.         Mhz clocks.  432 is recommended for 8Mhz clocks.  PC-VCO will
  1047.         attempt to calculate the correct value if you set it smaller
  1048.         than 10.
  1049.  
  1050.           . Break delay
  1051.  
  1052.         As noted above, the break delay is controlled through the Milli-
  1053.         second loop value.  This value "break delay" specifies the num-
  1054.         ber of "milliseconds" the comm line is held when a break is
  1055.         issued (Cntl-END).
  1056.  
  1057.           . Display delay
  1058.  
  1059.         The display delay value gives the number of seconds the dialing
  1060.         window is held on the screen (Alt-D command), and the maximum
  1061.         number of seconds the "Alarm" will be sounded.
  1062.  
  1063.           . Modem char delay
  1064.  
  1065.         The modem char delay gives the number of milliseconds PC-VCO
  1066.         delays after each character of a modem control sequence (e.g.
  1067.         dialing, hangup, initialization).  Certain modems require
  1068.         their control sequences be enunciated slowly.
  1069.  
  1070.           . Redial delay
  1071.  
  1072.         The interval between Alt-R (and script %C) redial attempts is
  1073.         established here.  45 seconds is recommended if long distance
  1074.         dialing is involved.  30 seconds is adequate for local calls.
  1075.  
  1076.           . Chat Window
  1077.  
  1078.         The size of the lower window of chat mode (where what you type
  1079.         appears) can be changed.  Regardless of the value you declare,
  1080.         the chat window cannot be smaller than 2 or larger than 10.
  1081.  
  1082.        4. Save
  1083.  
  1084.           You may change values for one execution of PC-VCO, or you may
  1085.           change them for all subsequent executions of PC-VCO.  If you
  1086.           save values, the values you've saved will be used the next time
  1087.           you run PC-VCO.
  1088.  
  1089.  
  1090. PC-VCO:  IBM PC Visual Conferencing                       Page 21
  1091. Version 1.3:  861222
  1092.  
  1093.  
  1094. X.    Program Configuration (continued)
  1095.  
  1096.  
  1097.     B. Communications Parameters (Alt-P)
  1098.  
  1099.        1. Rate + Parity + Data bits + Stop Bits
  1100.  
  1101.           Baud rate, parity, number of data bits and number of stop bits
  1102.           are specified in combination through the first 10 selections on
  1103.           the Alt-P window.  These selections are the only way you may
  1104.           specify baud rate (and, of course, the Alt-D dialing directory).
  1105.           Other parameters (parity, data bits, and stop bits) may be set
  1106.           individually (below).
  1107.  
  1108.           Do not change the current setting after you've connected to a
  1109.           service.    XMODEM can and does change to no parity (if necessary),
  1110.           but you shouldn't.
  1111.  
  1112.        2. Parity, Data bits and Stop bits
  1113.  
  1114.           Individual settings for parity, number of data bits and number of
  1115.           stop bits comprise the next 7 items of this menu.  You also set
  1116.           these values when you create a dialing directory entry.
  1117.  
  1118.           Again - do not change the current setting after you've connected
  1119.           to a service.  The settings on this screen are effective mostly
  1120.           when the program is initialized.    The dialing directory (if used)
  1121.           overrides the current setting.
  1122.  
  1123.        3. COM ports
  1124.  
  1125.           The last two items on this menu are the two candidates for COM
  1126.           ports.  Select the appropriate port for your modem.  This item
  1127.           is usually selected once, and then left alone.
  1128.  
  1129.        4. Save
  1130.  
  1131.           You save the current settings for the next execution of PC-VCO
  1132.           through the "Save" selection.  Settings are saved to disk.
  1133.  
  1134.  
  1135. PC-VCO:  IBM PC Visual Conferencing                       Page 22
  1136. Version 1.3:  861222
  1137.  
  1138.  
  1139. X.    Program Configuration (continued)
  1140.  
  1141.  
  1142.     C. Options (Alt-O)
  1143.  
  1144.        1. Settings otherwise available
  1145.  
  1146.           . Echo
  1147.  
  1148.         PC-VCO will accept keyboard entry and issue it through the
  1149.         COM port.  Some services turn around what you enter so that you
  1150.         see it (full duplex or echoplex) and some don't (half duplex).
  1151.         You may force PC-VCO to display what you enter in the CRT window
  1152.         by toggling echo.  Setting echo on (through the Alt-O window)
  1153.         will turn echo on now.    Saving it will cause echo to be turned
  1154.         on the next time you run PC-VCO.
  1155.  
  1156.         Echo is toggled dynamically with the Alt-E command.
  1157.  
  1158.           . Parity mask
  1159.  
  1160.         You can mask parity from every received character by setting
  1161.         the parity mask on permanantly through the Alt-O window.  I've
  1162.         found this to be useful - mandatory when I've needed it.
  1163.  
  1164.         Parity masking is toggled dynamically with the Alt-Z command.
  1165.  
  1166.           . Keyboard display
  1167.  
  1168.         Some talk systems are more friendly when what you type is not
  1169.         mixed in with what you receive.  Turning system echo off (if
  1170.         the system echoes key-entry) can be accomplished in a number
  1171.         of ways (note that this is different from program echo above).
  1172.  
  1173.         However - all of a sudden you have a new problem - you don't
  1174.         see what you're typing!  Keyboard display in PC-VCO is one
  1175.         attempt to solve this problem.    What you type will be displayed
  1176.         on the status line when keyboard display is turned on.    You can
  1177.         turn it on permanently through this selection.
  1178.  
  1179.         Keyboard display may be toggled dynamically with the F8 in CRT
  1180.         mode, and through the Controls pull-down in VCO mode.
  1181.  
  1182.           . Chat mode
  1183.  
  1184.         Chat mode may be set as a default when PC-VCO is loaded.  Chat
  1185.         mode is another attempt to allow you to see what you've typed
  1186.         when echo has been turned off.
  1187.  
  1188.         Chat mode may be toggled with Alt-A in CRT or VCO mode.  Chat
  1189.         mode is not used in VCO mode.
  1190.  
  1191.  
  1192. PC-VCO:  IBM PC Visual Conferencing                       Page 23
  1193. Version 1.3:  861222
  1194.  
  1195.  
  1196. X.    Program Configuration (continued)
  1197.  
  1198.  
  1199.     C. Options (Alt-O)
  1200.  
  1201.        1. Settings otherwise available (continued)
  1202.  
  1203.           . Blank line suppression
  1204.  
  1205.         Blank lines may be suppressed on the CRT side (they are auto-
  1206.         matically suppressed on the VCO side).    You can set blank line
  1207.         suppression on when PC-VCO is loaded through this option.
  1208.  
  1209.         Blank line suppression can be dynamicaly toggled with Alt-G.
  1210.  
  1211.           . Default VCO-II: Delphi/GEnie
  1212.  
  1213.         When PC-VCO was distributed, the default expression set was
  1214.         set for PLINK/CIS.  Harry Chesley's VCO uses a different set.
  1215.         You set the default used at program load time here.
  1216.  
  1217.         This mode is dynamically changed through the Controls pull-down.
  1218.  
  1219.  
  1220.        2. Settings available only through Alt-O
  1221.  
  1222.           . Alarm noise
  1223.  
  1224.         An alarm (of sorts) will play when the Alt-R re-dial makes
  1225.         connection, and when XMODEM file transfer is complete.    The
  1226.         noise is also played when certain error conditions occur.
  1227.  
  1228.         You can turn it off now and for subsequent executions through
  1229.         this selection.  You can turn it back on later.
  1230.  
  1231.           . Exit query
  1232.  
  1233.         Some people disdain the query "do you really and truly mean it"
  1234.         when they type Alt-X.  Some feel it mandatory.    PC-VCO is
  1235.         distributed with exit query disabled.  You may enable it, if
  1236.         you're so inclined, through this Alt-O selection.
  1237.  
  1238.           . Mark transcript
  1239.  
  1240.         PC-VCO can mark every disk transcript taken (beginning and
  1241.         end) with the date and time.  You tell PC-VCO not to mark
  1242.         further transcripts through this Alt-O selection.
  1243.  
  1244.         The transcript function also has the capability to add the
  1245.         backscreen (up to the last 4096 characters received) to the
  1246.         transcript.  Turning transcript marking off means that there
  1247.         will be no delimiter between the backscreen and the transcript.
  1248.  
  1249.  
  1250. PC-VCO:  IBM PC Visual Conferencing                       Page 24
  1251. Version 1.3:  861222
  1252.  
  1253.  
  1254. X.    Program Configuration (continued)
  1255.  
  1256.  
  1257.     C. Options (Alt-O)
  1258.  
  1259.        2. Settings available only through Alt-O (continued)
  1260.  
  1261.           . Initial advertisement
  1262.  
  1263.         When PC-VCO was distributed, the Information screen (Alt-I)
  1264.         was set to be displayed when the program was run.  You turn
  1265.         it off through this Alt-O setting.
  1266.  
  1267.           . WXMODEM send and receive
  1268.  
  1269.         PC-VCO was distributed with Windowed XMODEM enabled as a proto-
  1270.         col.  WXMODEM is entirely automatic in its implementation and
  1271.         does not interfere with use on systems that don't support it.
  1272.         However - you can turn it off on the send (upload) and receive
  1273.         (download) side with this setting, should you not want it.
  1274.  
  1275.        3. Save
  1276.  
  1277.           Values set through this screen are not automatically saved to
  1278.           disk.  Values set through this screen are immediately used by
  1279.           PC-VCO.  However, to configure PC-VCO to have the same settings
  1280.           the next time it is loaded, you must Save them with the "Save"
  1281.           selection of the Alt-O menu.
  1282.  
  1283.           One curious note.  Most of the Alt-O choices display the current
  1284.           setting - as opposed to displaying exactly what will be used the
  1285.           next time PC-VCO is loaded.  When you save your Alt-O settings
  1286.           be sure that ALL the settings are the way you want them.
  1287.  
  1288.  
  1289.     D. Colors (Alt-J)
  1290.  
  1291.        You may set foreground and background colors for (1) the CRT text
  1292.        area, (2) the status line, and (3) most menus (queries are set to
  1293.        black and white for contrast).  The color names are those used in
  1294.        the IBM Technical reference - if you have different name for some
  1295.        of the color values, I'm sorry.
  1296.  
  1297.        Like other option menus, you can experiment with settings.  Unless
  1298.        you save your settings, they are lost when the program terminates.
  1299.  
  1300.        One curiousity.  To use ANSI graphics, you must turn off colors.
  1301.        For this reason, the /B switch, and %E7 script commands have been
  1302.        implemented (refer to Appendix A and the next section).
  1303.  
  1304.  
  1305. PC-VCO:  IBM PC Visual Conferencing                       Page 25
  1306. Version 1.3:  861222
  1307.  
  1308.  
  1309. XI.    File Transfer (F3, F4, F5, F6, Alt-F)
  1310.  
  1311.  
  1312.     A. Xmodem Upload (F3)
  1313.  
  1314.        Files may be transferred to a system that accepts CHECKSUM, CRC or
  1315.        Windowed XMODEM using PC-VCO.  When you request XMODEM upload, you
  1316.        are asked for a file.  Once the file's existence has been assured,
  1317.        PC-VCO will begin protocol negotiation with the host system.  One of
  1318.        the three possible protocols will be negotiated - according to the
  1319.        host's capabilities.   Up to 60 seconds are allowed for the negoti-
  1320.        ation.  If that time is exceeded, the transfer fails.  You may
  1321.        restart it, of course.
  1322.  
  1323.  
  1324.        PC-VCO is intended primarily for users of X.25 networks and services
  1325.        available through the networks.  For this reason, PC-VCO implements
  1326.        what is referred to as "relaxed XMODEM".  The X.25 networks intro-
  1327.        duce timing delays into file transfers that the original XMODEM
  1328.        standard did not contemplate.  However - the relaxed XMODEM works
  1329.        quite well with BBS's that expect strict XMODEM.
  1330.  
  1331.  
  1332.        Because PC-VCO is intended for a network environment, it implements
  1333.        a new XMODEM variant - Windowed XMODEM or WXMODEM.  WXMODEM was
  1334.        designed to accomodate network delays and maximize performance.  It
  1335.        has proven stable in PC-VCO and gives approximately 35% faster trans-
  1336.        fer rates.  For details about WXMODEM refer to Appendix F.
  1337.  
  1338.  
  1339.        PC-VCO changes the communications parameters to 8 data bits, no
  1340.        parity, and 1 stop bit when XMODEM begins.  It restores settings
  1341.        to their original state after XMODEM completes.
  1342.  
  1343.  
  1344.        The XMODEM upload window displays:
  1345.  
  1346.        . the file name of the file being transferred,
  1347.        . its size,
  1348.        . the method (CRC or CHECKSUM),
  1349.        . the number of blocks being transferred,
  1350.        . the time so far,
  1351.        . the number of blocks sent,
  1352.        . if WXMODEM, the current 'window' size
  1353.        . the number of errors encountered,
  1354.        . and a description of the last error encountered.
  1355.  
  1356.  
  1357.        This function is not available in VCO mode.
  1358.  
  1359.  
  1360. PC-VCO:  IBM PC Visual Conferencing                       Page 26
  1361. Version 1.3:  861222
  1362.  
  1363.  
  1364. XI.    File Transfer (continued)
  1365.  
  1366.  
  1367.     B. Xmodem Download (F4)
  1368.  
  1369.        Files may be transferred from a system that implements Windowed,
  1370.        CHECKSUM or CRC XMODEM using PC-VCO.  When you request XMODEM down-
  1371.        load, you are asked for a file name.  Once the file has been created
  1372.        (it will be purged if it already exists), PC-VCO will begin protocol
  1373.        negotiation with the host system.  One of the three will be    nego-
  1374.        tiated - PC-VCO preferring Windowed - according to the host's cap-
  1375.        abilities.  PC-VCO first tries to negotiate WXMODEM.  If the host
  1376.        does not acknowlege WXMODEM, CRC XMODEM is requested.  If the host
  1377.        does not aknowlege CRC XMODEM, then finally, CHECKSUM is requested.
  1378.        Up to 100 seconds are allowed for the negotiation.  If that time is
  1379.        exceeded, the transfer fails.  You may restart it, of course.
  1380.  
  1381.  
  1382.        PC-VCO is intended primarily for users of X.25 networks and services
  1383.        available through the networks.  For this reason, PC-VCO implements
  1384.        what is referred to as "relaxed XMODEM".  The X.25 networks intro-
  1385.        duce timing delays into file transfers that the original XMODEM
  1386.        standard did not contemplate.  However - the relaxed XMODEM works
  1387.        quite well with BBS's that expect strict XMODEM.
  1388.  
  1389.  
  1390.        Because PC-VCO is intended for a network environment, it implements
  1391.        a new XMODEM variant - Windowed XMODEM or WXMODEM.  WXMODEM was
  1392.        designed to accomodate network delays and maximize performance.  It
  1393.        has proven stable in PC-VCO and gives approximately 35% faster trans-
  1394.        fer rates.  For details about WXMODEM refer to Appendix F.
  1395.  
  1396.  
  1397.        PC-VCO changes the communications parameters to 8 data bits, no
  1398.        parity, and 1 stop bit when XMODEM begins.  It restores settings
  1399.        to their original state after XMODEM completes.
  1400.  
  1401.  
  1402.        The XMODEM download window displays:
  1403.  
  1404.        . the file name of the file being transferred,
  1405.        . the method (CRC or CHECKSUM),
  1406.        . the time so far,
  1407.        . the file size so far,
  1408.        . the number of blocks received,
  1409.        . the number of errors encountered,
  1410.        . and a description of the last error encountered.
  1411.  
  1412.  
  1413.        This function is not available in VCO mode.
  1414.  
  1415.  
  1416. PC-VCO:  IBM PC Visual Conferencing                       Page 27
  1417. Version 1.3:  861222
  1418.  
  1419.  
  1420. XI.    File Transfer (continued)
  1421.  
  1422.  
  1423.     C. ASCII Upload (F5)
  1424.  
  1425.        Files may be transferred to a system using a  simple 'send' (as if
  1426.        entered by hand).  When ASCII upload is requested, you are prompted
  1427.        for a file name.  Once the existance of the file has been assured,
  1428.        you are prompted with a small menu with various options.
  1429.  
  1430.  
  1431.        Transfer may occur in two ways: 1) with a prompt from the host (some
  1432.        special character) or 2) without a host prompt for every line.
  1433.        The first item on the ASCII send options menu specifies if the host
  1434.        will prompt.  If this is set to 'On', you will be asked for the
  1435.        prompt character (either an ASCII or a control character).
  1436.  
  1437.  
  1438.        Line feeds may or may not be suppressed during the transmission.
  1439.        The next item specifies whether to do so.  ASCII text files contain
  1440.        line feeds that you (usually) do not want to transmit.  Similarly,
  1441.        tab characters may or may not be expanded during the transmission.
  1442.        The last item specifies whether to do so.  ASCII text files contain
  1443.        tabs that you (usually) want to expand before transmission.
  1444.  
  1445.  
  1446.        Transfer is, in all cases, paced (timed).  Transmission begins at
  1447.        maximum speed.  You may alter the pacing with the Cntl-PgUp and
  1448.        Cntl-PgDn keys during the transmission.  Cntl-Home will increase
  1449.        the speed to its maximum.  Cntl-End decreases the transmission
  1450.        speed to its minimum.  ESC or F1-F10 will terminate the send.
  1451.  
  1452.  
  1453.        The ASCII send function in PC-VCO responds to XON/XOFF sequences
  1454.        transmitted by the host.  When an XOFF is received, PC-VCO waits
  1455.        up to 15 seconds for a subsequent XON to be received.  Transmission
  1456.        is suspended while PC-VCO waits.  Transmission resumes after 15
  1457.        seconds, or after PC-VCO receives an XON.
  1458.  
  1459.  
  1460.        This function is not available in VCO mode.
  1461.  
  1462.        -------------------------------------------------------------------
  1463.        NOTE: When you specify host prompting, the first line is sent and
  1464.        then PC-VCO waits for a host prompt.  Should you loose the prompt
  1465.        from the host (inadvertantly, of course), the left arrow key (or
  1466.        function key not defined for use here) will cause the next line to
  1467.        be sent.
  1468.        -------------------------------------------------------------------
  1469.        NOTE: The percent transmitted will be incorrect when the file
  1470.        being transmitted is small - less than 1000 bytes.  Don't be
  1471.        surprised.  I was.
  1472.  
  1473. PC-VCO:  IBM PC Visual Conferencing                       Page 28
  1474. Version 1.3:  861222
  1475.  
  1476.  
  1477. XI.    File Transfer (continued)
  1478.  
  1479.  
  1480.     D. ASCII Download (F6)
  1481.  
  1482.        This differs from transcripting in that no extra characters are
  1483.        added to the file (e.g. line feeds after received carriage returns,
  1484.        or end-of-file).  Transcripting is intended to result in an ASCII
  1485.        edit file (or a printed log with a control-z terminator (!!)).
  1486.  
  1487.  
  1488.        Anything you type while the download function is being performed
  1489.        will be sent to the host system.  ESC or F1-F10 terminates the
  1490.        receive function and closes the capture file.
  1491.  
  1492.  
  1493.        This function is not available in VCO mode.
  1494.  
  1495.  
  1496.     E. File directory
  1497.  
  1498.        You may request a directory of files on any legitimate disk
  1499.        with the Alt-F command.  A search mask is requested - enter one
  1500.        just as you would with the DIR command of DOS.  For example:
  1501.  
  1502.         D:*.TXT
  1503.  
  1504.        specifies all files with the extension "TXT" from the "D" drive.
  1505.        File names and modification dates are displayed, 20 at a time.
  1506.        When the list is exhausted, the amount of free space remaining on
  1507.        the specified drive is displayed.
  1508.  
  1509.  
  1510.        Should you wish a directory search of a subdirectory, you must
  1511.        enter a full file mask.  The mask:
  1512.  
  1513.         C:\TEMP
  1514.  
  1515.        specifies a search on the root directory for a file named TEMP
  1516.        with no extension.  If you wish to search the TEMP subdirectory
  1517.        of the root directory, enter:
  1518.  
  1519.         C:\TEMP\*.*
  1520.  
  1521. PC-VCO:  IBM PC Visual Conferencing                       Page 29
  1522. Version 1.3:  861222
  1523.  
  1524.  
  1525. XII.    Miscellaneous Functions
  1526.  
  1527.  
  1528.     A. Disk logging [transcripting] (F7/Controls pull-down)
  1529.  
  1530.        You may transcript what you receive to a disk (or PRN) with the
  1531.        "Disk logging" function.  The transcript will be marked with the
  1532.        date and time it began and ended if transcript marking is set on
  1533.        through the Alt-O screen.
  1534.  
  1535.        PC-VCO keeps the last 4096 characters received in a buffer for
  1536.        backscreen (or re-display).    When you turn transcripting on, you
  1537.        will be asked if the backscreen is to be recorded first.  If you
  1538.        respond "Y", the backscreen will be written to the transcript file
  1539.        before the "BEGIN" mark.
  1540.  
  1541.     B. Keyboard display (F8/Controls pull-down)
  1542.  
  1543.        Some talk systems are more friendly when what you type is not
  1544.        mixed in with what you receive.  Turning echo off (if the
  1545.        system echoes key-entry) can be accomplished in a number of
  1546.        ways (note that this is different from program echo above).
  1547.  
  1548.        However - all of a sudden you have a new problem - you don't
  1549.        see what you're typing!  Keyboard display in PC-VCO is one
  1550.        attempt to solve this problem.  What you type will be displayed
  1551.        on the status line when keyboard display is turned on.  You can
  1552.        turn it on permanently through this selection.
  1553.  
  1554.        Keyboard display may be set on permanently through the Alt-O
  1555.        options window.
  1556.  
  1557.     C. Chat mode (Alt-A)
  1558.  
  1559.        Chat mode is another attempt to make typing more friendly when
  1560.        what you type isn't echoed by the host.  A 'chat window' of 2-10
  1561.        lines may be opened just above the status line.  The last few lines
  1562.        you've typed are displayed there.
  1563.  
  1564.        Chat mode may be set on permanently through the Alt-O options window.
  1565.  
  1566.     D. Redisplay [backscreen] (Alt-B)
  1567.  
  1568.        PC-VCO keeps up to the last 4096 characters received for re-
  1569.        display.  When you request redisplay, the screen is cleared and
  1570.        the backscreen buffer begins scrolling.  The scroll starts at the
  1571.        oldest receipt, and continues to the point where the re-display
  1572.        was requested.
  1573.  
  1574.        Re-display is paced (timed).  Re-display begins at minimum speed.
  1575.        Alter the pacing with the Cntl-PgUp and Cntl-PgDn keys.  Pause
  1576.        the re-display with the space bar.  Cancel the re-display with
  1577.        the ESC key.
  1578.  
  1579.  
  1580. PC-VCO:  IBM PC Visual Conferencing                       Page 30
  1581. Version 1.3:  861222
  1582.  
  1583.  
  1584. XII.    Miscellaneous Functions (continued)
  1585.  
  1586.  
  1587.     E. Clear Screen (Alt-C and received TOF)
  1588.  
  1589.        The command Alt-C entered at the keyboard will clear the screen.
  1590.        Similarly, when the host sends a control-L (^L or decimal 12)
  1591.        the screen is cleared.
  1592.  
  1593.     F. Echo (Alt-E)
  1594.  
  1595.        PC-VCO will accept keyboard entry and issue it through the
  1596.        COM port.  Some services turn around what you enter so that you
  1597.        see it (full duplex or echoplex) and some don't (half duplex).
  1598.        You may force PC-VCO to display what you enter in the CRT window
  1599.        by toggling echo.  Setting echo on through the Alt-O window will
  1600.        turn echo on now, and the next time you run PC-VCO.
  1601.  
  1602.        Echo is set through the dialing directory and permanently with the
  1603.        Alt-O options window.  The dialing directory controls, of course.
  1604.  
  1605.     G. Blank line suppression (Alt-G)
  1606.  
  1607.        Blank lines may be suppressed from the display if you wish.    This
  1608.        is especially useful where double spacing is done in the conference
  1609.        area.  Blank lines suppression only affects the CRT side display.
  1610.        The VCO side automatically suppresses blank lines.
  1611.  
  1612.        Blank line suppression may be set permanently with the Alt-O options
  1613.        window.
  1614.  
  1615.     H. Elapsed time (Alt-T)
  1616.  
  1617.        The time elapsed since the program was started, and since the last
  1618.        Alt-D dialing command or Alt-R is displayed through the Alt-T
  1619.        window.
  1620.  
  1621.     I. Voice toggle (Alt-V)
  1622.  
  1623.        Voice in PC-VCO now has two 'ON' modes: explicit and implicit.
  1624.        Implicit speech is voicing everything (that the poor speech driver
  1625.        can handle).  Explicit speech must be signalled with a '~{', '~[',
  1626.        '{', or '['.  The word following the signal must occur in the
  1627.        exception file.
  1628.  
  1629.        To turn voice on, you must have loaded the speech driver before
  1630.        loading PC-VCO.  Voice may be toggled off/on-implicit with Alt-V.
  1631.  
  1632.  
  1633. PC-VCO:  IBM PC Visual Conferencing                       Page 31
  1634. Version 1.3:  861222
  1635.  
  1636.  
  1637. XII.    Miscellaneous Functions (continued)
  1638.  
  1639.  
  1640.     J. Program termination (Alt-X)
  1641.  
  1642.        PC-VCO is exited (and returns to DOS) through the Alt-X command.
  1643.        The usual query "are you sure" is issued if "Exit query" is turned
  1644.        on through the Alt-O window.
  1645.  
  1646.        When you exit PC-VCO the COM line is dropped, unless you ran PC-VCO
  1647.        with the /P switch (piggyback).  If piggyback was set, the COM line
  1648.        is not dropped.
  1649.  
  1650.     K. Parity (hi-bit) mask (Alt-Z)
  1651.  
  1652.        You can mask parity from every received character by setting
  1653.        the parity mask on permanantly through the Alt-O window.  I've
  1654.        found this to be useful - mandatory when I've needed it.
  1655.  
  1656.        Some services require you to logon with 8 data bits, no parity, if
  1657.        you intend to download (or upload files).  When there is an X.25
  1658.        network between your PC and the service, certain characters (such
  1659.        as backspace are transmitted with parity on - regardless of your
  1660.        setting).  In these cases, parity masking is very nice to have.
  1661.  
  1662.        Toggle the current parity mask setting with Alt-Z.
  1663.  
  1664.  
  1665. PC-VCO:  IBM PC Visual Conferencing                       Page 32
  1666. Version 1.3:  861222
  1667.  
  1668.  
  1669. XIII.    DOS Gateway (Alt-F10)
  1670.  
  1671.  
  1672.     PC-VCO provides a gateway to a DOS shell through the Alt-F10 key.
  1673.     The DOS gateway requires a few preliminaries, however.
  1674.  
  1675.     .  There must be sufficient memory for the current DOS shell
  1676.        (COMMAND.COM usually), PC-VCO, and a second DOS shell.  If there
  1677.        isn't, the Alt-F10 will be rejected for 'insufficient memory'.
  1678.  
  1679.     .  There must be an environment variable 'COMSPEC' that points to
  1680.        the DOS shell to be loaded by Alt-F10.  If this variable is
  1681.        missing (has been deleted), COMMAND.COM on the default drive,
  1682.        root directory will be used (if present).
  1683.  
  1684.  
  1685.     When the DOS gateway is entered, you will be able to execute any
  1686.     DOS function that the specified shell supports.  Memory availble to
  1687.     that shell will be decreased by the presence of PC-VCO still running.
  1688.  
  1689.  
  1690.     You can return to PC-VCO by exiting the DOS shell.  If the shell is
  1691.     COMMAND.COM, type the command 'EXIT'.
  1692.  
  1693.     ------------------------------------------------------------------
  1694.     NOTE:  In order to make full use of the DOS gateway, you should
  1695.     provide yourself with the capacity for more open files than the
  1696.     default.  You can increase the number of files that may be open at
  1697.     one time by editing the file CONFIG.SYS on the root directory of
  1698.     your boot disk, adding a line: "FILES=n", where n is a number from
  1699.     1 to 20.  At least 12 is recommended.  Refer to your DOS manual for
  1700.     particulars.
  1701.  
  1702.  
  1703. PC-VCO:  IBM PC Visual Conferencing                       Page 33
  1704. Version 1.3:  861222
  1705.  
  1706.  
  1707. XIV.    Script Language
  1708.  
  1709.  
  1710.     A script facility has been added to PC-VCO.  It is accessible at load
  1711.     time (/F switch), or within the program (F2).  The script language
  1712.     parallels that of PROCOMM.  The only command whose meaning(s) have
  1713.     changed is %F. The %F parallels the PC-VCO Alt-P menu, as PROCOMM's %F
  1714.     parallels its Alt-P menu.  Under most usages this make no difference.
  1715.  
  1716.  
  1717.     Script commands are provided to PC-VCO through an ASCII file (word
  1718.     processor files are not usually ASCII files!).    A script command is
  1719.     signalled by a '%' sign.  The % must be followed by one, two or three
  1720.     alpha-numeric characters (no blanks) and possibly a quoted string (e.g.
  1721.     "GENIE.CMD").  Text on a line not a part of a valid command is ignored.
  1722.  
  1723.  
  1724.     Any line not containing a command is ignored.  Multiple commands may
  1725.     be placed on a single line.  SYNTAX errors are reported, however.
  1726.     On 'end-of-file', PC-VCO returns to the normal interactive mode (unless
  1727.     %Q was specified in the script).
  1728.  
  1729.  
  1730.     Currently, the command set is:
  1731.  
  1732.     %A    Alarum
  1733.  
  1734.         The %A command causes the PC-VCO alarm to sound, unless sound
  1735.         has been turned off (through Alt-O, or the %SN command below).
  1736.         The alarm sounds for the time specifed by 'display delay' in
  1737.         the Alt-S menu (or overridden by %ST "nn" below).  Press any
  1738.         key to terminate the alarm before the timeout.
  1739.  
  1740.     %B"str" Default Drive/path - unimplemented
  1741.  
  1742.         PC-VCO does not use its own 'default drive/path' concept. File
  1743.         names may be given with complete path specification.  If not,
  1744.         the current DOS default drive/subdirectory controls.  For this
  1745.         reason, %B has not been implemented.
  1746.  
  1747.     %C"nn"  Call directory number
  1748.  
  1749.         The %C command dials the number given in dialing directory
  1750.         number "nn".  The 'call' function waits for the 'CONNECT'
  1751.         string defined through the Alt-S Setup menu.  %C will redial
  1752.         the number (as does Alt-R) using the redial delay specified
  1753.         through Alt-S (or %R below).
  1754.  
  1755.  
  1756. PC-VCO:  IBM PC Visual Conferencing                       Page 34
  1757. Version 1.3:  861222
  1758.  
  1759.  
  1760. XIV.    Script Language (continued)
  1761.  
  1762.  
  1763.     %D"str" DOS command
  1764.  
  1765.         The %D command will execute the quoted string as a DOS command.
  1766.         PC-VCO loads a COMMAND.COM (similar to the DOS gateway used
  1767.         through Alt-F10) and executes "str" using COMMAND.COM as a
  1768.         transient processor.  To use the %D command, you must have
  1769.         sufficient memory and file handles (FILES=) to execute Alt-F10.
  1770.  
  1771.     %En    Emulations - unimplemented except for ANSI BBS
  1772.  
  1773.         PROCOMM offers emulation of a number of popular terminals.
  1774.         PC-VCO does not.  PC-VCO accepts PROCOMM %En commands and
  1775.         with the exception of %E7, reports them unimplemented.    %E7
  1776.         turns of screen colors (if on) to allow ANSI graphics.
  1777.  
  1778.         %En commands are:
  1779.  
  1780.     *    %E0        Unimplemented
  1781.     *    %E1        Unimplemented
  1782.     *    %E2        Unimplemented
  1783.     *    %E3        Unimplemented
  1784.     *    %E4        Unimplemented
  1785.     *    %E5        Unimplemented
  1786.     *    %E6        Unimplemented
  1787.         %E7        ANSI-BBS (color turned off)
  1788.     *    %E8        Unimplemented
  1789.     *    %E9        Unimplemented
  1790.  
  1791.     %Fn    Comm Parms (equivalent to selection 'n' from Alt-P)
  1792.  
  1793.         PC-VCO allows the setting of communications parameters inter-
  1794.         actively though the Alt-P command.  In usual practice, this is
  1795.         rarely used as the communications parameters specified through
  1796.         the dialing directory override the current setting.  Certain
  1797.         applications however - especially where scripting is handy -
  1798.         need this feature.  Therefore, %Fn.  The 'n' parallels the
  1799.         menu item number of the Alt-P menu.
  1800.  
  1801.         %F 'n' values are:
  1802.  
  1803.         %F1    300,E,7,1        %F11    Even parity
  1804.         %F2    1200,E,7,1        %F12    Odd parity
  1805.         %F3    2400,E,7,1        %F13    No parity
  1806.         %F4    4800,E,7,1        %F14    7 data bits
  1807.         %F5    9600,E,7,1        %F15    8 data bits
  1808.         %F6    300,N,8,1        %F16    1 stop bit
  1809.         %F7    1200,N,8,1        %F17    2 stop bit
  1810.         %F8    2400,N,8,1        %F18    COM1
  1811.         %F9    4800,N,8,1        %F19    COM2
  1812.         %F10    9600,N,8,1
  1813.  
  1814. PC-VCO:  IBM PC Visual Conferencing                       Page 35
  1815. Version 1.3:  861222
  1816.  
  1817.  
  1818. XIV.    Script Language (continued)
  1819.  
  1820.  
  1821.     %G    Screen dump - unimplemented
  1822.  
  1823.         The PROCOMM %G command performs a screen dump to the file
  1824.         PROCOMM.IMG.  It has not been implemented in this version of
  1825.         PC-VCO.  If the absence of this function makes difficult proper
  1826.         script file execution, please contact the author.
  1827.  
  1828.     %H    Hang up
  1829.  
  1830.         The %H command is equivalent to hanging up the phone or using
  1831.         the (interactive) Alt-H keystroke.  One note:  If you are using
  1832.         a bulletin board (as opposed to a timesharing system such as
  1833.         CIS or PLINK), the BBS sysop requests that you exit the BBS
  1834.         before you hangup the phone.  It's a courtesy...
  1835.  
  1836.     %I"str" Wait for incoming string
  1837.  
  1838.         The %I command waits for text to be received.  For example,
  1839.         %I "USER ID:" waits for the string "USER ID:" to be received
  1840.         (without the quotes, of course).  The case of the string is
  1841.         signifigant.  The command as above would not catch the string
  1842.         "User ID:".  All text that is received during a %I wait is
  1843.         displayed on the screen.
  1844.  
  1845.         The %I command will not wait for text indefinitely.  It times
  1846.         out after a certain number of seconds (and the script merrily
  1847.         proceeds anyway).  Initially the timeout is 60 seconds.  You
  1848.         can set a different timeout with the %P command below.
  1849.  
  1850.     %Jn    Send macro string 'n', n=0-9
  1851.  
  1852.         The %J command is equivalent to the 'Send Macro' interactive
  1853.         command (Alt-0 through Alt-9).    Macros are defined through
  1854.         the (interactive) Alt-M command.  A macro can be a combina-
  1855.         tion of text and control characters.  You must prepare the
  1856.         macro definition (Alt-M) prior to using it in a script.
  1857.  
  1858.  
  1859. PC-VCO:  IBM PC Visual Conferencing                       Page 36
  1860. Version 1.3:  861222
  1861.  
  1862.  
  1863. XIV.    Script Language (continued)
  1864.  
  1865.  
  1866.     %Ks    KERMIT server commands - unimplemented
  1867.  
  1868.         PROCOMM supports the KERMIT protocol.  PC-VCO does not.
  1869.         PC-VCO accepts PROCOMM %Ks commands and simply reports them
  1870.         unimplemented.
  1871.  
  1872.         %Ks commands are:
  1873.  
  1874.     *    %KMn        Unimplemented
  1875.     *    %KR        Unimplemented
  1876.     *    %KS"File_Name"  Unimplemented
  1877.     *    %KF        Unimplemented
  1878.     *    %KL        Unimplemented
  1879.  
  1880.     %Ls    Log commands
  1881.  
  1882.         The %L series of commands may be used to open and close a disc
  1883.         or printer log (or logs) during script execution.  Once opened,
  1884.         a log may be suspended and resumed at will.
  1885.  
  1886.         %Ls commands are:
  1887.  
  1888.         %LO "File_Name" Open log using "File_Name" (no default)
  1889.         %LH        Hold logging
  1890.         %LR        Resume logging
  1891.         %LC        Close log
  1892.  
  1893.     %M"str" Display a message on the screen
  1894.  
  1895.         The %M command displays the string (without the quotes, of
  1896.         course) to the screen - and writes it to the log if logging is
  1897.         turned on.  The string is not transmitted out the COM port.
  1898.         Macro conventions apply to the %M string - "!" may be used as
  1899.         a carriage return, "^" may be used to make a control character.
  1900.  
  1901.  
  1902. PC-VCO:  IBM PC Visual Conferencing                       Page 37
  1903. Version 1.3:  861222
  1904.  
  1905.  
  1906. XIV.    Script Language (continued)
  1907.  
  1908.  
  1909.     %N"str" Prompt for input and send
  1910.  
  1911.         The %N command opens a menu window and prompts for input from
  1912.         the keyboard.  Whatever is entered is transmitted out the COM
  1913.         port (with a carriage return added).  The string specified is
  1914.         displayed in the prompt window.
  1915.  
  1916.         The prompt string is limited to 64 characters.    Macro conven-
  1917.         tions do NOT apply to this string.  It is displayed as written.
  1918.         Up to 60 characters will be accepted and transmitted.
  1919.  
  1920.     %Os    BIOS/Direct screen writes
  1921.  
  1922.         PROCOMM offers a choice between direct or BIOS screen updates.
  1923.         PC-VCO does not (it uses BIOS for color mode, DOS for B&W).
  1924.         PC-VCO accepts PROCOMM %Os commands and simply reports them
  1925.         unimplemented.
  1926.  
  1927.         %Os commands are:
  1928.  
  1929.     *    %OB        Write to screen through BIOS - unimplemented
  1930.     *    %OD        Write to screen direct - unimplemented
  1931.  
  1932.     %P"nn"  Seconds to wait for an incoming string
  1933.  
  1934.         The %P command specifies the number of seconds the %I command
  1935.         will wait for incoming text before timing out.    You may set
  1936.         this value up to 3600 seconds (1 hour).
  1937.  
  1938.         The %P value is expressed in seconds.
  1939.  
  1940.     %Q    Quit program
  1941.  
  1942.         The %Q command terminates a script execution and exits PC-VCO.
  1943.         Anything in the script file after %Q will not be executed.
  1944.         PC-VCO immediately returns to DOS (after closing files and
  1945.         the COM port, and resetting the screen).
  1946.  
  1947.     %R"nn"  Redial delay value
  1948.  
  1949.         The redial delay (time between dialing attempts) used by the
  1950.         %C command above (and Alt-R, after the script terminates) may
  1951.         be set with the %R command.  Initially, the value specified
  1952.         through the Alt-S Setup menu controls.    The %R command changes
  1953.         the value - note that it remains in effect after the script
  1954.         terminates.  The value will be reset the next time PC-VCO is
  1955.         loaded (unless Alt-S is used to save the new value).
  1956.  
  1957.         The %R value is expressed in seconds.
  1958.  
  1959.  
  1960. PC-VCO:  IBM PC Visual Conferencing                       Page 38
  1961. Version 1.3:  861222
  1962.  
  1963.  
  1964. XIV.    Script Language (continued)
  1965.  
  1966.  
  1967.     %Ss    Sound controls.
  1968.  
  1969.         Alarm sounds and the duration of the alarm may be set through
  1970.         the %Ss command.  This is equivalent to the interactive Alt-O
  1971.         options settings and the Alt-S Setup 'display delay' value.
  1972.  
  1973.         %Ss commands are:
  1974.  
  1975.         %SY        Allow alarm sounds
  1976.         %SN        No alarm sounds (though alarm will delay)
  1977.         %ST"nn"         Set delay for alarm (value in seconds)
  1978.  
  1979.     %T"str" Transmit string
  1980.  
  1981.         The %T command transmits the string (without the quotes, of
  1982.         course) out the COM port - and echoes it to the screen if ECHO
  1983.         is turned on.  Macro conventions apply to the %T string...
  1984.         "!" may be used as a carriage return, "^" may be used to make
  1985.         a control character.  The length of the string is limited to
  1986.         250 or so characters.
  1987.  
  1988.     %Us    Miscellaneous - implemented as applicable
  1989.  
  1990.         Various control functions are provided through the %U command.
  1991.         PROCOMM defines %U0 through %U9... however, not all the func-
  1992.         tions provided are applicable to PC-VCO.   All the %U commands
  1993.         are accepted by PC-VCO.  Those left unimplemented are marked.
  1994.  
  1995.         %U commands are:
  1996.  
  1997.         %U1        Clear screen
  1998.     *    %U2        Send CR as CR - unimplemented
  1999.     *    %U3        Send CR as CR/LF - unimplemented
  2000.         %U4        Set full duplex
  2001.         %U5        Set half duplex
  2002.         %U6        Send Break signal
  2003.     *    %U7        Set line wrap on - unimplemented
  2004.     *    %U8        Set line wrap off - unimplemented
  2005.     *    %U9        Set Scroll on - unimplemented
  2006.     *    %U0        Set Scroll off - unimplemented
  2007.  
  2008.  
  2009. PC-VCO:  IBM PC Visual Conferencing                       Page 39
  2010. Version 1.3:  861222
  2011.  
  2012.  
  2013. XIV.    Script Language (continued)
  2014.  
  2015.  
  2016.     %Vs    Miscellaneous - VCO specific subvommands
  2017.  
  2018.         The PROCOMM script language does not implement a %V command
  2019.         (at least the version I last used - and yes I am a registered
  2020.         PROCOMM user!).  PC-VCO happily appropriated it for PC-VCO
  2021.         specific functions.
  2022.  
  2023.         %V commands are:
  2024.  
  2025.     ->    %V0        Voice off
  2026.     ->    %V1        Voice on - explicit
  2027.     ->    %V2        Voice on - implicit
  2028.     ->    %V3        Blank line suppression on (Alt-G)
  2029.     ->    %V4        Blank line suppression off (Alt-G)
  2030.     ->    %V5        High bit masking on (Alt-Z)
  2031.     ->    %V6        High bit masking off (Alt-Z)
  2032.     ->    %V7        Chat mode on (Alt-A)
  2033.     ->    %V8        Chat mode off (Alt-A)
  2034.     ->    %V9        WXMODEM send allowed
  2035.     ->    %VA        WXMODEM send not allowed
  2036.     ->    %VB        WXMODEM receive allowed
  2037.     ->    %VC        WXMODEM receive not allowed
  2038.     ->    %VD"File_Name"  Set VCO library file name
  2039.     ->    %VE"File_Name"  Set VCO Exception file name
  2040.     ->    %VF        PLINK/CIS mode (VCO side)
  2041.     ->    %VG        GEnie/Delphi mode (VCO side)
  2042.  
  2043.     %W"nn"  Wait for a specified # seconds
  2044.  
  2045.         The %W command waits for a specified interval.    All text that
  2046.         is received during a %W wait is displayed on the screen.  The
  2047.         fact of the %W command and its duration is displayed on the
  2048.         status line.  A %W wait can be cancelled with the ESC key.
  2049.  
  2050.     %Xs    XMODEM receive/send
  2051.  
  2052.         The %X command allows you to send and receive files from a
  2053.         script using PC-VCO's version of the XMODEM protocol.  PC-VCO
  2054.         implements checksum and CRC XMODEM as its standard.  PC-VCO
  2055.         also offers Windowed XMODEM optionally (it may be turned off).
  2056.  
  2057.         %Xs commands are:
  2058.  
  2059.         %XR"File_Name"
  2060.         %XS"File_Name"
  2061.  
  2062.  
  2063. PC-VCO:  IBM PC Visual Conferencing                       Page 40
  2064. Version 1.3:  861222
  2065.  
  2066.  
  2067. XIV.    Script Language (continued)
  2068.  
  2069.  
  2070.     %Ys    ASCII Send
  2071.  
  2072.         The %Y command allows you to send and receive files from a
  2073.         script using PC-VCO's version of an ASCII protocol.  PC-VCO
  2074.         implements an ASCII protocol in its own manner.  The PROCOMM
  2075.         pacing option is not offered... rather an inter-character delay
  2076.         can be set.  Other choices should be self-expanatory.
  2077.  
  2078.         %Ys commands are:
  2079.  
  2080.     *    %YP"nn"         Set pacing: unimplemented
  2081.         %YT"File_name"  Transmit file_name using ASCII send
  2082.     ->    %Y0"str"        Set host prompt character
  2083.     ->    %Y1        Turn off host prompt character
  2084.     ->    %Y2        Transmit linefeeds on
  2085.     ->    %Y3        Transmit linefeeds off
  2086.     ->    %Y4        Tab expansion on
  2087.     ->    %Y5        Tab expansion off
  2088.     ->    %Y6"nn"         Set intercharacter delay (in milliseconds)
  2089.  
  2090.     %Zs    Translate tables - unimplemented.
  2091.  
  2092.         The PROCOMM %Z command activates and deactivates translation
  2093.         table.    Translation tables have not been implemented in this
  2094.         version of PC-VCO.  PC-VCO accepts and reports as unimplemented
  2095.         the %Z command if present on a script.
  2096.  
  2097.         %Zs commands are:
  2098.  
  2099.     *    %ZY        Translate table on - unimplemented
  2100.     *    %ZN        Translate table off - unimplemented
  2101.  
  2102.  
  2103.     ----------------------------------------------------------------------
  2104.     The notation '->' to the left of a script command indicates that it is
  2105.     not a part of the PROCOMM script language.  These extensions were added
  2106.     for PC-VCO, to provide its features to script file users.
  2107.     ----------------------------------------------------------------------
  2108.     The notation '*' to the left of a script command indicates that it is
  2109.     unimplemented (but will be accepted).  Commands marked 'unimplemented'
  2110.     are parsed and accepted by PC-VCO.  SYNTAX errors in command formation
  2111.     are reported, whether all of the command is implemented or no.
  2112.     ----------------------------------------------------------------------
  2113.     Note that PC-VCO must be in CRT mode to execute a script.  If this
  2114.     poses a dramatic limitation, write me, and we'll talk.
  2115.  
  2116.  
  2117. PC-VCO:  IBM PC Visual Conferencing                       Page 41
  2118. Version 1.3:  861222
  2119.  
  2120.  
  2121. XV.    Program Requirements
  2122.  
  2123.  
  2124.     This program can only function on an IBM PC or DOS compatible machine.
  2125.     If the VCO side of the program is to be used, the machine must be
  2126.     equipped with a color graphics display adapter.  Although an EGA would
  2127.     provide a more close resemblance to the MacIntosh environment, no
  2128.     use of the EGA is planned at this time.  PC-VCO does direct to screen
  2129.     buffer fetches and stores - so compatibility is an important issue.
  2130.  
  2131.  
  2132.     PC-VCO disk I/O is done through the 'Handle' oriented I/O routines
  2133.     added to DOS 2.0.  Therefore DOS 2.0 is a minimum requirement.    The
  2134.     current speech driver (by Douglas Sisco) will not function with
  2135.     DOS 3.xx, its document states.
  2136.  
  2137.  
  2138.     PC-VCO (version 1.3) requires 144K for itself.    So you need 192.
  2139.     You need 256K to take advantage of the DOS Gateway.
  2140.  
  2141. PC-VCO:  IBM PC Visual Conferencing                       Page 42
  2142. Version 1.3:  861222
  2143.  
  2144.  
  2145. XVI.    Program and Author Information
  2146.  
  2147.  
  2148.     This program was written using Microsoft Macro-Assembler.  The author
  2149.     likes assembler.  Assembly language is an entirely appropriate vehicle
  2150.     for some of the program, and a not-inappropriate vehicle for the rest
  2151.     of it.    Everything, in moderation...
  2152.  
  2153.  
  2154.     The author of this program is R. Scott McGinnis of Chicago, Illinois.
  2155.     PLINK and GEnie ID: TARTAN.  Comment and suggestions (and criticism
  2156.     in moderation) are welcomed:
  2157.  
  2158.              R. (Scott) McGinnis
  2159.              P.O. Box 3607 Mdse Mart
  2160.              Chicago, IL 60654-0607
  2161.  
  2162.  
  2163.     Credit for information on the VCO must be given to Kelly Major and
  2164.     Mike Cohen.  Credit for help on graphic displays and conversions must
  2165.     be given to Mark Lewis.  All three I've met through People/Link.
  2166.     Collegues at 'the office', Bruce Clemens, Joe Noonan, Milton Treshansky,
  2167.     and Al Paluszek have helped immeasurably with technical comments,
  2168.     suggestions, and support.  My wife, Elizabeth, supported me whole-
  2169.     heartedly in this effort.
  2170.  
  2171.  
  2172.     This program (Version 1.3) may be distributed freely with the caveat
  2173.     that the Author information displayed at program termination is not
  2174.     removed.  If the program is found entertaining or useful, a contrib-
  2175.     ution of $35.00 is requested.  Should response warrant it, I will
  2176.     continue to develop and support this product.
  2177.  
  2178.  
  2179.     Most of the hardware names and software names in this document are
  2180.     trademarks or trade names of specific manufacturers.
  2181.  
  2182.  
  2183. PC-VCO:  IBM PC Visual Conferencing                       Page 43
  2184. Version 1.3:  861222                            Appendices
  2185.  
  2186.  
  2187. A.    Switches and parameters
  2188.  
  2189.  
  2190.     Program Switches:
  2191.  
  2192.     /1  'PLINK/CIS': Expressions sent and received are compatible with
  2193.         VCO (by Mike Cohen) as used on PLINK, and VMCO (by Bob Perez)
  2194.         as used on CIS.  This is the default for distributed copies.
  2195.  
  2196.     /2  'Delphi/GEnie': Expressions sent and received are compatible with
  2197.         VCO (by Harry Chesley) as used on Delphi and GEnie.  You may make
  2198.         this the permanent default with the Alt-O menu.
  2199.  
  2200.     /A  'Chat mode':  PC-VCO can be set to default to the chat mode split
  2201.         screen through the Alt-O options menu.  However, you may wish  to
  2202.         turn chat on for some systems and off for others.  The /A switch
  2203.         allows the decision to be made through a batch file.
  2204.  
  2205.     /B  'Black and White mode': PC-VCO can be set to use or not use colors
  2206.         on-screen through the Alt-J Colors menu.  However, if you usually
  2207.         use the colors option, you will find ANSII graphics ignored.  This
  2208.         switch allows the colors to be turned off at PC-VCO run time.
  2209.  
  2210.     /F  'Execute script':  The /F switch followed by a legitimate file name
  2211.         (for example /FPLINK.CMD) will cause the designated file to be used
  2212.         as a script after PC-VCO is loaded.  Note that a file name extension
  2213.         is not assumed or added (as does PROCOMM).
  2214.  
  2215.     /G  'Graphics Mode':  PC-VCO is to begin in graphics (or VCO) mode.
  2216.         This would be used with piggyback if the network had already
  2217.         been accessed through another program.
  2218.  
  2219.     /J  'Blank line suppression': Blank lines are used to double space
  2220.         on some systems.  Alt-G toggles a blank line suppression feature
  2221.         interactively.  /J in the run command turns the feature on when
  2222.         PC-VCO is loaded.  This feature can also be set through Alt-O.
  2223.  
  2224.     /M  'Maug' mode.  The graphic display does not use a Speaker's box
  2225.         and thus allows a full 80 columns for text display.
  2226.  
  2227.     /P  'Piggyback':  PC-VCO will open the COM port in such a manner as
  2228.         to retain another program's already opened line.  When PC-VCO is
  2229.         exited, the previous state is restored.  This is for use with
  2230.         other communications programs having a DOS Gateway (e.g. Procomm).
  2231.  
  2232.         At last test, this feature did not work.
  2233.  
  2234.  
  2235. PC-VCO:  IBM PC Visual Conferencing                       Page 44
  2236. Version 1.3:  861222                            Appendices
  2237.  
  2238.  
  2239. A.    Switches and parameters (continued)
  2240.  
  2241.  
  2242.     Program Switches (continued)
  2243.  
  2244.     /R  'Report Receive Errors':  This switch causes all receive errors to
  2245.         be reported.  During testing, certain nodes of certain networks
  2246.         consistantly reported framing errors.  The apparent error did not
  2247.         interfere with communications so report of it was suppressed.
  2248.  
  2249.     /S  'Send Discipline':  This switch causes a more robust discipline to
  2250.         be used when transmitting characters out through the COM port.
  2251.         CTS and DSR are turned high, and response awaited if this switch
  2252.         is set.  During testing it was found that this discipline would
  2253.         not allow certain modems to be used (though Smartmodem seemed
  2254.         happy as a clam).  The excess discipline was unnecessary, and
  2255.         therfore made a switchable setting.
  2256.  
  2257.     /T  'Text Mode':  PC-VCO is to begin in text (or CRT) mode.  This is
  2258.         the default.
  2259.  
  2260.     /V  'Voice on': PC-VCO may be loaded with voice turned on (implicit
  2261.         mode) with the /V switch.  The speech driver must be loaded before
  2262.         PC-VCO is run with the /V switch.
  2263.  
  2264.         Voice in PC-VCO now has two 'ON' modes: explicit and implicit.
  2265.         Implicit speech is voicing everything (that the poor speech driver
  2266.         can handle).  Explicit speech must be signalled with a '~{', '~[',
  2267.         '{', or '['.  The word following the signal must occur in the
  2268.         exception file.
  2269.  
  2270.     /VE 'Voice on, explicit':  The /VE switch turns on the voice inter-
  2271.         face, and sets the voice mode 'explicit' (above).  The speech
  2272.         driver must be loaded before PC-VCO is executed.
  2273.  
  2274.     /VI 'Voice on, implicit':  The /VI switch turns on the voice inter-
  2275.         face, and sets the voice mode 'implicit' (above).  The speech
  2276.         driver must be loaded before PC-VCO is executed.
  2277.  
  2278.     /X  'Debug mode': This switch enables certain resident debugging keys
  2279.         (such as Cntl-F1, which prints a 64K dump to PRN).    I do not
  2280.         recommend you use it.  I document it only for the VERY curious.
  2281.  
  2282.  
  2283. PC-VCO: IBM PC Visual Conferencing                       Page 45
  2284. Version 1.3:  861222
  2285.  
  2286.  
  2287. A.    Switches and Parameters (continued)
  2288.  
  2289.  
  2290.     Program parameters:
  2291.  
  2292.        COM1     PC-VCO uses the COM1 port
  2293.        COM2     PC-VCO uses the COM2 port
  2294.  
  2295.        300        PC-VCO uses port at 300 baud
  2296.        1200     PC-VCO uses port at 1200 baud
  2297.        2400     PC-VCO uses port at 2400 baud
  2298.        4800     PC-VCO uses port at 4800 baud
  2299.        9600     PC-VCO uses port at 9600 baud
  2300.  
  2301.        EVEN     PC-VCO uses port with even parity
  2302.        ODD        PC-VCO uses port with odd parity
  2303.        NONE     PC-VCO uses port with no parity
  2304.  
  2305.        DATA7    PC-VCO transmits/receives 7 data bits
  2306.        DATA8    PC-VCO transmits/receives 8 data bits
  2307.  
  2308.        STOP1    PC-VCO uses and expects 1 stop bit
  2309.        STOP2    PC-VCO uses and expects 2 stop bits
  2310.  
  2311.        DIAL <n>    After initialization, PC-VCO dials directory entry
  2312.             <n>, using the rate, parity, data and stop bits as
  2313.             specified.
  2314.  
  2315.  
  2316.     Program switches require no delimiters.  Parameters must be preceded
  2317.     by a blank.  For example:
  2318.  
  2319.     A> PC-VCO 1200        Run the program for 1200 baud communications
  2320.     A> PC-VCO /P/G1200    Piggyback, immediate VCO mode, 1200 baud
  2321.     A> PC-VCO /P/G 1200    Piggyback, immediate VCO mode, 1200 baud
  2322.  
  2323.  
  2324.     Program defaults are:
  2325.  
  2326.     A> PC-VCO /T COM2 300 EVEN DATA7 STOP1
  2327.  
  2328.  
  2329. PC-VCO:  IBM PC Visual Conferencing                       Page 46
  2330. Version 1.3:  861222                            Appendices
  2331.  
  2332.  
  2333. B.    PC-VCO Error display.
  2334.  
  2335.  
  2336.     One command not listed in the F10 help display is Alt-Y.  This
  2337.     command displays RS232 and file errors encountered.  RS232 errors
  2338.     list both the last error condition recorded and a count of errors.
  2339.     RS232 errors are:
  2340.  
  2341.     Receive error.    The hex value represents:
  2342.  
  2343.        Bit 0:  Shouldn't occur in display, but what do I know.
  2344.            1:  Overrun.  Indicates that a character in the 8250
  2345.            Receive buffer was not read before the next character
  2346.            was received.  This program enables interrupts to read
  2347.            the COM port.
  2348.        Bit 2:  Parity error.  Indicates that the parity of the
  2349.            received character does not match that specified.
  2350.        Bit 3:  Framing error.  Indicates that the character received
  2351.            lacked a valid stop bit.  This bit report is normally
  2352.            suppressed, but may be enabled with the /R switch.
  2353.        Bit 4:  Break interrupt. Not too many systems send a break.
  2354.  
  2355.        Other bits of the LSR of the 8250 are masked off.
  2356.  
  2357.     Send error.  The hex value represents:
  2358.  
  2359.        Bit 8:  A timeout occurred in one of three places:
  2360.            . Waiting for DSR to go true
  2361.            . Waiting for CTS to go true
  2362.            . Waiting for the transmit holding register to clear
  2363.            The first two conditions are normally suppressed,
  2364.            but may be overridden with the /S switch.
  2365.  
  2366.        Other bits are masked out. There is serious trouble (or my over-
  2367.        sight) if anything but Hex 80 is reported.
  2368.  
  2369.     Buffer overflow.
  2370.  
  2371.        This program uses an interrupt service routine to read the
  2372.        COM port.  The ISR fills a 4096 byte buffer.  The application
  2373.        takes characters out of the circular receive buffer one by
  2374.        one.  Buffer overflow may occur when the application is
  2375.        suspended - for example when a menu is pulled-down.
  2376.  
  2377.  
  2378. PC-VCO:  IBM PC Visual Conferencing                       Page 47
  2379. Version 1.3:  861222                            Appendices
  2380.  
  2381.  
  2382. C.    Speech driver
  2383.  
  2384.  
  2385.     The speech function of PC-VCO is supplied by a resident speech driver.
  2386.     The resident driver and associated programs (SAY and READ) were found
  2387.     on a public domain Bulletin Board in Chicago.  The author's name is
  2388.     not contained in the documentation, and no statement is made as to its
  2389.     ownership or copyright.
  2390.  
  2391.  
  2392.     The author IS identified within the executable object files.  I have
  2393.     attempted to contact the individual there named.  No response has been
  2394.     received.  If the author cannot be contacted, or if the resident
  2395.     speech driver is not public domain, the driver will not be included
  2396.     in PC-VCO's public distribution.  [Note: 861222: The speech driver was
  2397.     not included in the distribution.  Its author has not responded.]
  2398.  
  2399.  
  2400.     PC-VCO only implements an interface to the driver.  Other drivers
  2401.     may be had to do the same or similar function.    Interfaces to other
  2402.     text-to-speech resident drivers (or linked-in) are contemplated.
  2403.     A second text-to-speech driver is being pursued right now.
  2404.  
  2405.  
  2406.     It is hoped that PC-VCO will eventually find a Speech driver that can
  2407.     support variations in speaking rates and pitch.
  2408.  
  2409.  
  2410. PC-VCO:  IBM PC Visual Conferencing                       Page 48
  2411. Version 1.3:  861222                            Appendices
  2412.  
  2413.  
  2414. D.    Exception File
  2415.  
  2416.  
  2417.     The exception file distributed with PC-VCO is virtually that used by
  2418.     the MacIntosh VCO.  The exception file is a simple text file, each
  2419.     line of which has the syntax:
  2420.  
  2421.          "[" <keyword> "]"  "=" <translation>
  2422.  
  2423.  
  2424.     There are three types of keyword in the current exception file:
  2425.  
  2426.     .  Keywords without a special delimiter (e.g. [6] which gives a
  2427.        pronunciation for numeric 6)
  2428.  
  2429.     .  Keywords with the initial delimiter "{".  MacIntosh documentation
  2430.        states that these are to be displayed but not spoken.  Why are
  2431.        they in the exception file?    Beats me.
  2432.  
  2433.     .  Keywords with the initial delimiter "[" (in addition to the
  2434.        initial bracket).  MacIntosh documentation states that these are
  2435.        to be voiced, and not displayed.
  2436.  
  2437.  
  2438.     PC-VCO follows these rules, more or less.  The exception file as
  2439.     prepared for the MacIntosh MacTalk produces some odd results with
  2440.     the present speech driver.  Some changes have been made, but not
  2441.     alot.  Perhaps some brave soul will pitch in.
  2442.  
  2443.  
  2444.     On the other hand, the exception file does provide pronunciation
  2445.     for tokens that otherwise would be skipped by the present speech
  2446.     driver (e.g. simple numerics).
  2447.  
  2448.  
  2449. PC-VCO:  IBM PC Visual Conferencing                       Page 49
  2450. Version 1.3:  861222                            Appendices
  2451.  
  2452.  
  2453. E.    Files
  2454.  
  2455.  
  2456.     Program files:    PC-VCO expects the following files on the
  2457.     default drive (and subdirectory)
  2458.  
  2459.     PC-VCO.DFT    Parameter save area (Alt-S and Alt-P)
  2460.     PC-VCO.DIR    Dialing directory (PROCOMM compatible)
  2461.     PC-VCO.MAC    Macro definition (PROCOMM compatible)
  2462.  
  2463.  
  2464.     PC-VCO will automatically update the .DFT file if the program version
  2465.     number is different from the .DFT file version number.    When PC-VCO is
  2466.     loaded, the old file format will be loaded.  A new file will then be
  2467.     created to replace the old file.
  2468.  
  2469.  
  2470.     PC-VCO will create these files if they are not present (with default
  2471.     values), an empty dialing directory, and empty macro definition).
  2472.     Different versions of PC-VCO will require different structures to
  2473.     the .DFT file... previous versions (with the exception of 1.0) will
  2474.     be accepted - however when a new major (e.g. 1.0, 2.0, ...) is
  2475.     released the previous .DFT file probably should be purged (and recreated
  2476.     by PC-VCO) or replaced with the new copy provided in the ARC.
  2477.  
  2478.  
  2479.     PC-VCO also uses (if available) the following files:
  2480.  
  2481.     PC-VCO.EXC    Exception file for speech processing
  2482.     PC-VCO.FLB    Face library
  2483.  
  2484.  
  2485.     Each of these file names may be changed through the ALT-S
  2486.     (Setup) Menu.  PC-VCO currently implements the rule for file
  2487.     names:    If the given file name carries a drive spec (i.e. C:)
  2488.     or path (subdirectory), the name is taken 'as is'.  If neither
  2489.     condition holds, the default drive and subdirectory are added
  2490.     to the file name.
  2491.  
  2492.  
  2493.     PC-VCO can share Dialing Directory and Macro Definition files
  2494.     with PROCOMM.  In this case the subdirectory on which these files
  2495.     may be found must be specified through the Alt-S function, and
  2496.     the values saved for subsequent executions.  PC-VCO's updates
  2497.     to these files will be acceptible to PROCOMM, and PROCOMM's to
  2498.     PC-VCO (True at least through version 2.0 of PROCOMM).
  2499.  
  2500.  
  2501.  
  2502. PC-VCO:  IBM PC Visual Conferencing                       Page 50
  2503. Version 1.3:  861222                            Appendices
  2504.  
  2505.  
  2506. F.    Windowed XMODEM (WXMODEM)
  2507.  
  2508.  
  2509.     In June, 1986, Peter Boswell of PLINK issued a specification for an
  2510.     XMODEM protocol variant called Windowed XMODEM (WXMODEM to friends).
  2511.     WXMODEM was designed primarily to overcome delays that are imposed by
  2512.     the X.25 networks.  X.25 network delays are mostly imperceptible to
  2513.     conversational users of the networks... however, users performing file
  2514.     transfers might expect to see up to 50% of the transfer time incurred
  2515.     by these delays!
  2516.  
  2517.  
  2518.     Asynchronous communications lines do not suffer these same delays.
  2519.     When someone accustomed to Bulletin Boards dialed through a direct phone
  2520.     lines enters the X.25 environment, the 'feel' of file transfers is found
  2521.     to be entirely 'too slow'.   The difference is entirely in the X.25 net-
  2522.     work (and many times intervening satellite hops).
  2523.  
  2524.  
  2525.     Windowed XMODEM also accomodates the requirements of new services such
  2526.     as PC Pursuit... allowing XON/XOFF flow control to be excercised by the
  2527.     network during a binary file transfer (this is not possible with XMODEM
  2528.     as transparency is required).  Flow control allows higher data rates to
  2529.     be supported while retaining existing network interconnects.
  2530.  
  2531.  
  2532.     Windowed XMODEM was implemented on PLINK in September, 1986.  Many comm
  2533.     programs on many different machines have been modified or written to
  2534.     implement WXMODEM for PLINK communications.  The difference in through-
  2535.     put between CRC XMODEM and WXMODEM is astounding.  I measure at least
  2536.     35% and sometimes as much as 40% improvement in transfer times.  In real
  2537.     terms, this means the difference between 24 minutes and 40 minutes for
  2538.     a download of the same (approximately 120K) file at 1200 baud.
  2539.  
  2540.  
  2541.     Windowed XMODEM is still a new protocol.  Its developers discovered
  2542.     quite a few practicalities not addressed in the original specification
  2543.     during its implementation.  In fact - these matters are currently being
  2544.     debated in the PLINK Amiga Club.  However - WXMODEM has proven to be a
  2545.     stable and satisfying implementation.  I'm delighted to add its power
  2546.     to PC-VCO.
  2547.  
  2548.  
  2549.     For the technically inclined, the Windowed XMODEM specification will be
  2550.     found on many bulletin boards and most systems as WXMODEM.ARC.    An
  2551.     excellent analysis of XMODEM problems in an X.25 environment by Peter
  2552.     Boswell will be found in the 'Protocol Project' section of the IBM Club
  2553.     of PLINK.  In the latter paper, Peter quantifies exactly the delays and
  2554.     their predicted overhead in the X.25 environment.
  2555.  
  2556. PC-VCO:  IBM PC Visual Conferencing                       Page 51
  2557. Version 1.3:  861222                            Appendices
  2558.  
  2559.  
  2560. G.    ANSI graphics
  2561.  
  2562.  
  2563.     PC-VCO is capable of displaying ANSI graphics on the CRT side.    ANSI
  2564.     graphics are used by some services and Bulletin Boards to enrich the
  2565.     display through the use of colors.
  2566.  
  2567.  
  2568.     PC-VCO does not itself execute the ANSI graphics.  An optional device
  2569.     driver, ANSI.SYS, is provided with DOS 2.0 and above for this purpose.
  2570.     Replacements for ANSI.SYS are available on all the systems and boards,
  2571.     offering increased functionality and additional utility.  For example,
  2572.     the FANSI device driver (shareware by Hersey Micro Consulting) offers:
  2573.  
  2574.     .  improvements in screen display speed,
  2575.     .  considerably more control sequences than ANSI.SYS,
  2576.     .  DEC VT100 emulation (which therefore is available to you in PC-VCO
  2577.        if you use FANSI),
  2578.     .  a backscreen function,
  2579.     .  one finger typing,
  2580.     .  increased typeahead buffer
  2581.     .  and many many other functional enhancements
  2582.  
  2583.  
  2584.     In order to use ANSI graphics through PC-VCO, you must have a device
  2585.     driver installed in your DOS.  This is very simply done.  If you opt
  2586.     to use ANSI.SYS, all that is required is that the text:
  2587.  
  2588.        DEVICE=ANSI.SYS
  2589.  
  2590.     be added to the file CONFIG.SYS on the root directory of your boot
  2591.     disk, and the PC re-booted (Ctl-Alt-Del).  If there is no CONFIG.SYS
  2592.     file on the root directory of your boot disk, create one containing
  2593.     the line above (see also the note on DOS gateway), and then re-boot.
  2594.  
  2595.  
  2596.     Other device drivers, as FANSI mentioned above, will have their own
  2597.     installation requirements.  Refer to the documentation for the device
  2598.     driver you wish to use in place of ANSI.SYS for instructions.
  2599.  
  2600.  
  2601.     Once you've installed the ANSI device, nothing more need be done.  When
  2602.     PC-VCO is run with 'screen colors off', ANSI graphics will be displayed.
  2603.     Some Bulletin boards will ask 'Do you want color graphics (Y/N)' when
  2604.     you enter (for example, Bulletin boards of the type 'PC Bulletin Board'
  2605.     ask this question).  Answer 'y' if you want the additional graphics.
  2606.  
  2607.  
  2608.     Some Bulletin boards even go so far as to provide music with their
  2609.     displays (for example, RBBS type Bulletin boards).  PC-VCO doesn't
  2610.     do music, right now.  It may in the future, if you want it to do so.
  2611.  
  2612. PC-VCO:  IBM PC Visual Conferencing                       Page 52
  2613. Version 1.3:  861222                            Appendices
  2614.  
  2615.  
  2616. H.    Example scripts
  2617.  
  2618.  
  2619.     A script to dial Telenet (entry number 10 in the provided dialing
  2620.     directory), and connect to a service looks like:
  2621.  
  2622.     ---------------------------------------------------------------------
  2623.     %M"^Gdialing PLINK through Telenet"
  2624.     %C"10"                  ; Call dial dir entry number 10 (Telenet)
  2625.     %T"!"                   ; Transmit Carriage return <CR>
  2626.     %T"!"                   ; Transmit Carriage return <CR>
  2627.     %I"TERMINAL="           ; Wait for "TERMINAL=" to be received
  2628.     %T"d1!"                 ; give telenet the terminal identifier
  2629.     %I"@"                   ; Wait for "@" to be received
  2630.     %T"C 312 63!"           ; Send request to telenet for PLINK
  2631.     %I"USER ID:"            ; Wait for "User ID:" to be received
  2632.     %A            ; Sound alarm
  2633.     ---------------------------------------------------------------------
  2634.  
  2635.     A script to dial a modem direct, send three carriage returns, and
  2636.     wait for the logon prompt looks like:
  2637.  
  2638.     ---------------------------------------------------------------------
  2639.     %M "^GDialing PLINK direct"
  2640.     %C"1"                   ; Call dial dir entry number 24 (PLINK)
  2641.     %W"5"                   ; Wait for the pad to settle down
  2642.     %T"!"                   ; Transmit Carriage return <CR>
  2643.     %W"1"                   ; Wait 1 sec
  2644.     %T"!"                   ; Transmit Carriage return <CR>
  2645.     %W"1"                   ; Wait 1 sec
  2646.     %T"!"                   ; Transmit Carriage return <CR>
  2647.     %I"USER ID:"            ; Wait for the 'USER ID' prompt
  2648.     %SY            ; Turn sound on
  2649.     %A            ; Sound alarm
  2650.     ---------------------------------------------------------------------
  2651.  
  2652. PC-VCO:  IBM PC Visual Conferencing                       Page 53
  2653. Version 1.3:  861222                            Appendices
  2654.  
  2655.  
  2656. I.    Command Index
  2657.  
  2658.     -------------------------------------------------------------
  2659.     Key    Meaning                     Page
  2660.     ------- ----------------------------------------------- -----
  2661.     ------- Commands available in CRT and VCO modes -------------
  2662.     -------------------------------------------------------------
  2663.  
  2664.     F1    Switch between CRT and VCO modes.        7
  2665.     F10    Help screen.                    7
  2666.     Alt-F10 DOS Gateway.                    32
  2667.     Ctl_End Send a Break.                    7
  2668.  
  2669.     Alt-A    Toggle chat mode (on CRT screen)        29
  2670.     Alt-B    Redisplay (backscreen).             29
  2671.     Alt-C    Clear the screen.                30
  2672.     Alt-D    Dialing directory.                14-15
  2673.     Alt-E    Toggle echo (full/half duplex).         30
  2674.     Alt-F    File directory.                 28
  2675.     Alt-G    Toggle blank line suppression            30
  2676.     Alt-H    Hang-up.                    16
  2677.     Alt-I    Program information.                7
  2678.     Alt-J    Set screen colors                24
  2679.     Alt-M    Define a macro for Alt-0 through Alt-9.     17
  2680.     Alt-O    Set program options.                22-24
  2681.     Alt-P    Comm Parameters.                21
  2682.     Alt-R    Redial the last number dialed.            16
  2683.     Alt-S    Setup.    Define initial program values.        18-20
  2684.     Alt-T    Elapsed time.                    30
  2685.     Alt-V    Toggle voice (off, on implicit)         30
  2686.     Alt-X    Exit the program.                31
  2687.     Alt-Y    Error information.                46
  2688.     Alt-Z    Toggle parity mask.                31
  2689.     Alt-0/9 Send a Macro.                    17
  2690.  
  2691.     -------------------------------------------------------------
  2692.     ------- Commands available only in CRT mode -----------------
  2693.     -------------------------------------------------------------
  2694.  
  2695.     F2    Perform a script                33-40
  2696.     F3    XMODEM upload.                    25
  2697.     F4    XMODEM download.                26
  2698.     F5    ASCII upload.                    27
  2699.     F6    ASCII download.                 28
  2700.     F7    Toggle logging (transcripting).         29
  2701.     F8    Toggle display of typed characters.        29
  2702.     F9    Toggle Log hold.                10
  2703.